Agent skill

Aidd Structure

Enforces source code structuring and interdependency best practices.

MITAuto-check passed

Install Aidd Structure

skills CLI

$ npx skills add paralleldrive/aidd --skill aidd-structure -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install paralleldrive/aidd aidd-structure --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/paralleldrive/aidd.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ai/skills/aidd-structure .claude/skills/aidd-structure && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "aidd-structure" agent skill from https://github.com/paralleldrive/aidd/tree/main/ai/skills/aidd-structure into .claude/skills/aidd-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aidd-structure", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/paralleldrive/aidd/tree/main/ai/skills/aidd-structure

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add paralleldrive/aidd --skill aidd-structure -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install paralleldrive/aidd aidd-structure --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/paralleldrive/aidd.git skills-src && mkdir -p .agents/skills && cp -r skills-src/ai/skills/aidd-structure .agents/skills/aidd-structure && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "aidd-structure" agent skill from https://github.com/paralleldrive/aidd/tree/main/ai/skills/aidd-structure into .agents/skills/aidd-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aidd-structure", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add paralleldrive/aidd --skill aidd-structure -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install paralleldrive/aidd aidd-structure --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/paralleldrive/aidd.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/ai/skills/aidd-structure .cursor/skills/aidd-structure && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "aidd-structure" agent skill from https://github.com/paralleldrive/aidd/tree/main/ai/skills/aidd-structure into .cursor/skills/aidd-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aidd-structure", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/paralleldrive/aidd.git --path ai/skills/aidd-structure

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add paralleldrive/aidd --skill aidd-structure -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install paralleldrive/aidd aidd-structure --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/paralleldrive/aidd.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/ai/skills/aidd-structure .gemini/skills/aidd-structure && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "aidd-structure" agent skill from https://github.com/paralleldrive/aidd/tree/main/ai/skills/aidd-structure into .gemini/skills/aidd-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aidd-structure", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install paralleldrive/aidd aidd-structure

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add paralleldrive/aidd --skill aidd-structure -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/paralleldrive/aidd.git skills-src && mkdir -p .github/skills && cp -r skills-src/ai/skills/aidd-structure .github/skills/aidd-structure && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "aidd-structure" agent skill from https://github.com/paralleldrive/aidd/tree/main/ai/skills/aidd-structure into .github/skills/aidd-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aidd-structure", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add paralleldrive/aidd --skill aidd-structure -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install paralleldrive/aidd aidd-structure --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/paralleldrive/aidd.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/ai/skills/aidd-structure .opencode/skills/aidd-structure && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "aidd-structure" agent skill from https://github.com/paralleldrive/aidd/tree/main/ai/skills/aidd-structure into .opencode/skills/aidd-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aidd-structure", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: aidd-structure
GitHub stars: 384
Token cost: ~586 tokens
SKILL.md length: 101 words
Files: 2
Skills in repo: 35
Repo updated: Jun 12, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Enforces source code structuring and interdependency best practices.

Creating folders
SKILL.md covers Dependency rules, components, plugins (if using… and services, plus 3 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
The user asks about architecture

What it does

Aidd Structure is an agent skill from paralleldrive/aidd. Enforces source code structuring and interdependency best practices. Use when creating folders, moving files, adding imports, or when the user asks about architecture, layering, or module dependencies.

Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

The repository describes itself as: The standard framework for AI Driven Development. The licence is MIT.

When your agent uses it

Creating folders
The user asks about architecture
Module dependencies

Example prompts

“Use the aidd-structure skill to enforce source code structuring and interdependency best practices”
“/aidd-structure”

What it can do on your machine

Read from SKILL.md and the folder at commit 9a7c8e3. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are sudolang).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Aidd Structure loads about 586 tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 101 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~54
When it runs · the whole SKILL.md, loaded when a task matches: ~586

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from paralleldrive/aidd at commit 9a7c8e3, republished under its MIT licence (© paralleldrive). 101 words, ~586 tokens.

Download SKILL.mdSave it as .claude/skills/aidd-structure/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: aidd-structure
description: Enforces source code structuring and interdependency best practices. Use when creating folders, moving files, adding imports, or when the user asks about architecture, layering, or module dependencies.

Standard folder structure

types ← services ← plugins ← components
  ↑         ↑         ↑
  └─────────┴─────────┘ (types only depend on types)

Dependency rules

sudolang

LayerDependency {
  layer: "components" | "plugins" | "services" | "types"
  mayDependOn: String[]
  mustNotDependOn: String[]
}

DependencyRules [
  { layer: "components", mayDependOn: ["plugins (Observe<Data>, void actions)", "types"], mustNotDependOn: ["services"] },
  { layer: "plugins", mayDependOn: ["services", "types", "other plugins"], mustNotDependOn: [] },
  { layer: "services", mayDependOn: ["other services", "types"], mustNotDependOn: ["components", "plugins"] },
  { layer: "types", mayDependOn: ["other types"], mustNotDependOn: ["everything else"] }
]

Constraints {
  Never: components → services
  Never: services → components or plugins
  Never: types → anything except types
}

components

UI components or elements (also called "elements").

From plugins: only Observe<Data> for reactive re-renders and void-returning action functions.

plugins (if using @adobe/data/ecs for state)

ECS Database.Plugin declarations. Usually depend on services, types, and other plugins.

services

Asynchronous data services, each in its own folder. Immutable data only. Adhere to namespace guidelines.

Async patterns only: Observe<Data>, Promise<Data>, AsyncGenerator<Data>, void actions.

External code depends only on interfaces, never on implementations.

types

Pure functional types and associated pure functions. Adhere to namespace guidelines.

Nested structure

When a component has implementation-specific sub-parts, mirror the root structure inside it:

components/my-component/
  components/
  plugins/
  types/

Execute

sudolang

fn whenAddingOrMovingCode() {
  Constraints {
    Place code in the correct layer (components, plugins, services, types)
    Check dependencies against the dependency rules
    Fix any violations (e.g. components importing services)
  }
}

Files

SKILL.md and 1 other file in ai/skills/aidd-structure of paralleldrive/aidd.

SKILL.md
README.md

Open the folder on GitHubat commit 9a7c8e3

Compare with similar skills

Aidd Structure next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Aidd Structure compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Aidd Structure this skillparalleldrive/aidd	384	—	~586	Automated safety check: Pass	MIT	3 mo ago
Structured Datathedaviddias/Front-End-Checklist	74k	—	~420	Automated safety check: Pass	MIT	yesterday
Bio Structural Biology Modern Structure PredictionFreedomIntelligence/OpenClaw-Medical-Skills	3.1k	1 repos	~2.5k	Automated safety check: Pass	None	2 mo ago
List Structurethedaviddias/Front-End-Checklist	74k	—	~438	Automated safety check: Pass	MIT	yesterday
Bio Structural Biology Structure IoGPTomics/bioSkills	1.2k	1 repos	~4k	Automated safety check: Pass	MIT	1 mo ago
Bio Structural Biology Structure NavigationGPTomics/bioSkills	1.2k	1 repos	~3.7k	Automated safety check: Pass	MIT	1 mo ago

Similar skills

Structured Data
thedaviddias/Front-End-Checklist
A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Add structured data markup.
74k GitHub stars~420 tokensUpdated yesterday
Marketing & SEOAuto-check passed
Bio Structural Biology Modern Structure Prediction
FreedomIntelligence/OpenClaw-Medical-Skills
Predict protein structures using modern ML models including AlphaFold3, ESMFold, Chai-1, and Boltz-1.
3.1k GitHub starsUsed in 1 repo~2.5k tokens
Research & ScienceAuto-check passed
List Structure
thedaviddias/Front-End-Checklist
A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Use correct list structure.
74k GitHub stars~438 tokensUpdated yesterday
Frontend & DesignAuto-check passed
Bio Structural Biology Structure Io
GPTomics/bioSkills
Reads, writes, downloads, and converts macromolecular structures with Biopython Bio.PDB.
1.2k GitHub starsUsed in 1 repo~4k tokens
Research & ScienceAuto-check passed
Bio Structural Biology Structure Navigation
GPTomics/bioSkills
Navigate the Bio.PDB SMCRA hierarchy (Structure-Model-Chain-Residue-Atom) safely, surfacing the heterogeneity it hides by default.
1.2k GitHub starsUsed in 1 repo~3.7k tokens
Research & ScienceAuto-check passed
Bio Structural Biology Structure Preparation
GPTomics/bioSkills
Prepares a deposited or predicted structure for docking, molecular dynamics, or electrostatics by adding hydrogens, assigning protonation and tautomer states, and filling missing atoms and short…
1.2k GitHub starsUsed in 1 repo~4.9k tokens
Research & ScienceAuto-check passed

Questions about Aidd Structure

What does Aidd Structure do?

Enforces source code structuring and interdependency best practices. Aidd Structure is an agent skill from paralleldrive/aidd. Enforces source code structuring and interdependency best practices.

When should I use Aidd Structure?

Aidd Structure fits situations like: creating folders; the user asks about architecture; module dependencies.

How do I install Aidd Structure in Claude Code?

Run `npx skills add paralleldrive/aidd --skill aidd-structure -a claude-code`. Or copy the skill folder (ai/skills/aidd-structure in paralleldrive/aidd) into .claude/skills/aidd-structure in your project. Claude Code loads it when a task matches its description.

How do I install Aidd Structure in Codex?

Run `npx skills add paralleldrive/aidd --skill aidd-structure -a codex`. Or copy the skill folder (ai/skills/aidd-structure in paralleldrive/aidd) into .agents/skills/aidd-structure in your project. Codex loads it when a task matches its description.

Can I use Aidd Structure in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add paralleldrive/aidd --skill aidd-structure -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aidd-structure, .gemini/skills/aidd-structure, .github/skills/aidd-structure and .opencode/skills/aidd-structure in your project.

What does Aidd Structure need to run?

SKILL.md names no scripts, command-line tools or credentials: Aidd Structure is instructions for the agent only.

Does Aidd Structure access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Aidd Structure safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Aidd Structure use?

Aidd Structure is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Aidd Structure use?

About 586 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Aidd Structure?

Skills that share tags, products or a category with Aidd Structure: Structured Data (thedaviddias/Front-End-Checklist, 74k stars), Bio Structural Biology Modern Structure Prediction (FreedomIntelligence/OpenClaw-Medical-Skills, 3.1k stars), List Structure (thedaviddias/Front-End-Checklist, 74k stars) and Bio Structural Biology Structure Io (GPTomics/bioSkills, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aidd Structure?

paralleldrive (a GitHub organization) maintains it in paralleldrive/aidd, which has 384 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on June 12, 2026.

Source: paralleldrive/aidd on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Aidd Structure

Install Aidd Structure

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Standard folder structure

Dependency rules

components

plugins (if using @adobe/data/ecs for state)

services

types

Nested structure

Execute

Files

Compare with similar skills

Similar skills

Structured Data

Bio Structural Biology Modern Structure Prediction

List Structure

Bio Structural Biology Structure Io

Bio Structural Biology Structure Navigation

Bio Structural Biology Structure Preparation

More from paralleldrive/aidd

AIDD Skill Authoring Guide

AIDD UI Layout Patterns

Adobe Data ECS Plugin Rules

Error Causes Handling

JavaScript IO Effects With Sagas

Lit Element Authoring

Questions about Aidd Structure