Agent skill

Framework

by ai-driven-dev in ai-driven-dev/framework

Owns the installation record and everything done to a project, under src/contexts/framework/ — the manifest aggregate, and the setup/install/restore/uninstall/doctor orchestration built on top of it.

MITAuto-check passedProductivity & Automation

Install Framework

skills CLI
$ npx skills add ai-driven-dev/framework --skill framework -a claude-code

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

GitHub CLI
$ gh skill install ai-driven-dev/framework framework --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/ai-driven-dev/framework.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli/.claude/skills/framework .claude/skills/framework && 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/

Facts

Skill name
framework
GitHub stars
510
Token cost
~1.3k tokens
SKILL.md length
512 words
Files
3 (incl. references)
Skills in repo
52
Repo updated
First seen
Licence
MIT

At a glance

Owns the installation record and everything done to a project, under src/contexts/framework/ — the manifest aggregate, and the setup/install/restore/uninstall/doctor orchestration built on top of it.

  • Adding a use-case that touches the manifest
  • SKILL.md covers What goes in, How, Public surface and How it's tested
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • A setup/doctor/sync/uninstall flow

What it does

Framework is an agent skill from ai-driven-dev/framework. Owns the installation record and everything done to a project, under src/contexts/framework/ — the manifest aggregate, and the setup/install/restore/uninstall/doctor orchestration built on top of it. This is the only context allowed to reach translate and distribution; tools is reachable from telemetry too. Use when adding a use-case that touches the manifest, a setup/doctor/sync/uninstall flow, a new top-level CLI orchestration, or a launcher that runs an external binary (kanban-shaped). Do NOT use for a tool's…

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/manifest.md` and `references/post-install-pipeline.md`).

It sits in Productivity & Automation, covering Translation and Task management. The repository describes itself as: Marketplace Framework AI-Driven Dev : Context Engineering, Plugins, Agents, Skills, Hooks, Templates, SDLC. The licence is MIT.

When your agent uses it

  • Adding a use-case that touches the manifest
  • A setup/doctor/sync/uninstall flow
  • A new top-level CLI orchestration
  • A launcher that runs an external binary (kanban-shaped)

Example prompts

  • “/framework”

What it can do on your machine

Read from SKILL.md and the folder at commit 6e30640. 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.

    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

Framework loads about 1.3k tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 178 tokens; SKILL.md has 512 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~178
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.4k

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 ai-driven-dev/framework at commit 6e30640, republished under its MIT licence (© ai-driven-dev). 512 words, ~1,262 tokens.

Download SKILL.mdSave it as .claude/skills/framework/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
framework
description
Owns the installation record and everything done to a project, under src/contexts/framework/ — the manifest aggregate, and the setup/install/restore/uninstall/doctor orchestration built on top of it. This is the only context allowed to reach `translate` and `distribution`; `tools` is reachable from `telemetry` too. Use when adding a use-case that touches the manifest, a setup/doctor/sync/uninstall flow, a new top-level CLI orchestration, or a launcher that runs an external binary (kanban-shaped). Do NOT use for a tool's own profile or capability classes — use `tools`. Do NOT use for the translation pipeline — use `translate`. Do NOT use for where content is fetched from — use `distribution`.

Framework

framework is what is posed on a project and the record of it: the manifest that tracks every installed file, and every flow that reads or changes that record — setup, doctor, sync (restore), uninstall, plugin install/update/remove, and the global chain orchestrators. It is the one context the dependency chain lets reach every other context but telemetry (framework → translate → tools → kernel, plus framework → distribution), because assembling what goes on disk is exactly the job that needs all three.

What goes in

ConceptLocation
The manifest aggregate and its membersdomain/manifest.ts, domain/manifest/ (tool-entry, tracked-files, merge-files, native-registrations)
A plugin's declared statedomain/plugins/ (installed-plugin, source-resolver, requested-version-policy)
The diagnosis shapedomain/doctor.ts
Setup orchestration statedomain/setup-flow.ts
A port only framework needsdomain/ports/ (manifest-repository, plugin-distribution-reader, user-source-references)
A top-level flow's orchestratorapplication/ root, or a feature subdirectory (clean/, doctor/, flows/, framework/, global/, install/, plugin/, restore/, setup/, uninstall/)
Logic needed by ≥2 top-level use-casesapplication/shared/ — never called from a command
The manifest-repository and plugin-distribution-reader adaptersinfrastructure/

How

  • A use-case class ends in UseCase, has a single async execute(options): Promise<Result>, never catches its own errors except the three carve-outs (global aggregate-error loops, cache/network fallback, typed-throw translation) — see the use-case and orchestration rules in .claude/rules/00-architecture/.
  • A use case that installs framework files saves the manifest and updates .gitignore through PostInstallPipelineUseCase. A use case that only changes the manifest (plugin add/remove, marketplace sync, restore) saves it directly. See references/post-install-pipeline.md.
  • Before writing any framework file: check fs.fileExists(path) && !manifest.isFileTracked(path). If both are true, skip the write, warn, and never add it to the manifest — never overwrite a user-owned file. See references/manifest.md.
  • A global chain orchestrator (*-all-use-case.ts) iterates every scope and must finish even if one fails: wrap one iteration in try/catch, push a typed entry to an errors[] array, and return it in the result — never let one tool's failure abort the whole run.
  • A capability-guard sub-use-case (install-agents-use-case.ts and its siblings) checks "name" in caps before dispatching to a narrowed sub-use-case in install/ — see references/post-install-pipeline.md, section "Capability sub-use-cases". These five files reach directly into tools' capability classes rather than through a declared public module; that reach is a tracked, shrinking exception in context-boundary.arch.test.ts, not a pattern to add to.
  • A launcher spawns its target, never imports it. The decision and its cost are in aidd_docs/memory/architecture.md.
Show full SKILL.md (140 more words)Show less

Public surface

Nothing outside contexts/framework/ may import a module this context has not declared public. framework is also the context most other contexts should never see: nothing in tools, translate, or distribution may import from framework at all — the arrow only runs the other way. Check tests/architecture/context-graph.arch.test.ts before adding an edge; check context-boundary.arch.test.ts's PUBLIC_MODULES before assuming a module framework itself exposes is reachable from presentation or runtime.

How it's tested

  • tests/contexts/framework/ mirrors src/contexts/framework/ — domain models are unit-tier, use-cases against in-memory ports (tests/helpers/ports/) are unit or integration depending on whether they touch a real temp filesystem.
  • tests/e2e/ exercises full CLI invocations through runCli(); tests/golden/ snapshots a built framework tree end to end — see the test skill for tier and golden-snapshot rules.
  • A manifest version-guard change needs a fixture manifest at the boundary version, asserting the exact refusal message names the fix.

© ai-driven-dev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in cli/.claude/skills/framework of ai-driven-dev/framework.

  • SKILL.md
  • references/manifest.md
  • references/post-install-pipeline.md

Open the folder on GitHubat commit 6e30640

Compare with similar skills

Framework 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.

Framework compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Framework this skillai-driven-dev/framework510—~1.3kAutomated safety check: PassMIT
Fastgpt Workflow GeneratorYYH211/Claude-meta-skill282—~5.5kAutomated safety check: PassMIT
Relay Stack Playbookkxn/codex-remote-feishu328—~1.3kAutomated safety check: PassNone
Orca Linear Ticket Workflowstablyai/orca87k1 repos~522Automated safety check: PassMIT
Translation Diff ExportDevolutions/UniGetUI26k—~1.1kAutomated safety check: PassMIT
Sync Translationssymfony/symfony31k—~1.9kAutomated safety check: PassMIT

Similar skills

  • Fastgpt Workflow Generator

    YYH211/Claude-meta-skill

    Generates production-ready FastGPT workflow JSON from natural language requirements.

    282 GitHub stars~5.5k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Relay Stack Playbook

    kxn/codex-remote-feishu

    A skill your agent uses when working on this repository's relay stack: Codex app-server protocol translation, relayd, relay-wrapper, Feishu bot integration, VS Code remote integration, or real-stack…

    328 GitHub stars~1.3k tokensUpdated 6 days ago
    Productivity & AutomationAuto-check passed
  • Linear ticket work through Orca's CLI. Use when working from a linked Linear issue, finishing work with a PR/MR link and a completion comment, moving a ticket…

    87k GitHub starsUsed in 1 repo~522 tokens
    Productivity & AutomationAuto-check passed
  • Translation Diff Export

    Devolutions/UniGetUI

    Compares UniGetUI JSON locale files against English, identifies untranslated or source-changed keys, and generates patch, reference, and handoff files for a target language.

    26k GitHub stars~1.1k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Sync Translations

    symfony/symfony

    Synchronize translation catalogs across maintained Symfony branches: find messages that newer branches added to the English catalogs but that are still missing from the oldest maintained branch…

    31k GitHub stars~1.9k tokensUpdated today
    Writing & ContentAuto-check passed
  • Translation Diff Import

    Devolutions/UniGetUI

    Merges translated key-value pairs from a UniGetUI JSON localization patch back into the full language file and validates the merged result.

    26k GitHub stars~750 tokensUpdated yesterday
    Writing & ContentAuto-check passed

More from ai-driven-dev/framework

All 52 skills in this repo
  • 00 Async Dev

    ai-driven-dev/framework

    Drive the async-dev pipeline from one entry point, whether setup, run, or review.

    510 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • 01 Plan

    ai-driven-dev/framework

    Turn a request, ticket, or file into a phased implementation plan.

    510 GitHub stars~517 tokensUpdated today
    Auto-check passed
  • 01 Sdlc

    ai-driven-dev/framework

    Autonomously orchestrates a request from framing to a draft pull request, isolating implementation, independent review, and final outcome challenge.

    510 GitHub stars~583 tokensUpdated today
    Auto-check passed
  • 02 Backlog

    ai-driven-dev/framework

    Orchestrates a product backlog end to end. An agent skill from ai-driven-dev/framework.

    510 GitHub stars~613 tokensUpdated today
    Auto-check passed
  • 00 Onboard

    ai-driven-dev/framework

    Guide a project's journey through AIDD, from first setup to shipping a feature.

    510 GitHub stars~242 tokensUpdated today
    Auto-check passed
  • 01 Acceptance QA

    ai-driven-dev/framework

    Validate a reviewed candidate's observable behavior against its acceptance criteria and record short named videos as reviewer evidence.

    510 GitHub stars~434 tokensUpdated today
    Auto-check passed

Questions about Framework

What does Framework do?

Owns the installation record and everything done to a project, under src/contexts/framework/ — the manifest aggregate, and the setup/install/restore/uninstall/doctor orchestration built on top of it. Framework is an agent skill from ai-driven-dev/framework. Owns the installation record and everything done to a project, under src/contexts/framework/ — the manifest aggregate, and the setup/install/restore/uninstall/doctor orchestration built on top of it.

When should I use Framework?

Framework fits situations like: adding a use-case that touches the manifest; A setup/doctor/sync/uninstall flow; A new top-level CLI orchestration; A launcher that runs an external binary (kanban-shaped).

How do I install Framework in Claude Code?

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

How do I install Framework in Codex?

Run `npx skills add ai-driven-dev/framework --skill framework -a codex`. Or copy the skill folder (cli/.claude/skills/framework in ai-driven-dev/framework) into .agents/skills/framework in your project. Codex loads it when a task matches its description.

Can I use Framework 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 ai-driven-dev/framework --skill framework -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/framework, .gemini/skills/framework, .github/skills/framework and .opencode/skills/framework in your project.

What does Framework need to run?

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

Does Framework 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 Framework 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 Framework use?

Framework 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 Framework use?

About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Framework?

Skills that share tags, products or a category with Framework: Fastgpt Workflow Generator (YYH211/Claude-meta-skill, 282 stars), Relay Stack Playbook (kxn/codex-remote-feishu, 328 stars), Orca Linear Ticket Workflow (stablyai/orca, 87k stars) and Translation Diff Export (Devolutions/UniGetUI, 26k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Framework?

ai-driven-dev (a GitHub organization) maintains it in ai-driven-dev/framework, which has 510 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on October 7, 2026.

Source: ai-driven-dev/framework on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.