Stop pasting other people's agent skills into your repo as-is

Description and use

Skilladopt safely adapts agent skills to a project by adjusting commands to match the project’s stack and policies, reducing errors and manual editing.

Problem

Copying an agent skill unchanged into a repository can cause mismatches between the skill’s assumptions and the project’s stack, scripts, or policies, leading to incorrect or harmful behavior.

Outcome

Skilladopt enables safe, context-aware adoption of agent skills by automatically adjusting commands to match the project’s stack and policies, reducing errors and manual editing.

Workflow

• 1. Run npx skilladopt <repo> <skill> to fetch the skill at a pinned commit.
• 2. The tool sends the skill text and a short project summary to an isolated Claude or Codex worker.
• 3. The worker decides per paragraph: keep, bind, rewrite, drop, or review.
• 4. Each decision cites evidence from the repo (dependency, npm script, AGENTS.md, CLAUDE.md).
• 5. The tool validates decisions with plain code checks.
• 6. The adapted skill is saved with recorded decisions and evidence.
• 7. When project changes, run npx skilladopt impact to identify decisions that no longer hold.
• 8. Re-check affected lines and run npx skilladopt update <name> to re-fit the skill to its latest upstream version while reusing unchanged decisions.

Evidence

Copy one into your repo unchanged and your agent inherits all of that.

Source

It fetches the skill at a pinned commit and hands the text, plus a short summary of your project, to an isolated Claude or Codex worker.

Source

Each decision has to cite evidence from your repo: a dependency, an npm script, a line in AGENTS.md or CLAUDE.md.

Source

Because every decision recorded its evidence, skilladopt can tell which ones no longer hold.

Source