scaffold-skill

Scaffold Skill

A knowledge-oriented Agent Skill for writing, validating, and optionally packaging other Agent Skills inside a repository.

It teaches an agent how to inspect a repo, write portable SKILL.md directories by hand, add progressive-disclosure resources, and package a skill only when requested for:

• npx skills / skills.sh
• Claude Code plugins
• Codex plugins

Install

npx skills add backnotprop/scaffold-skill

List available skills first:

npx skills add backnotprop/scaffold-skill --list

Install globally:

npx skills add backnotprop/scaffold-skill -g -y

Install from a local checkout:

npx skills add ./scaffold-skill -y

npx skills add is the documented install command. The CLI also accepts install as an alias for add. experimental_install only restores from skills-lock.json.

As a Claude Code plugin

/plugin marketplace add backnotprop/scaffold-skill
/plugin install scaffold-skill@scaffold-skill

Local checkout:

/plugin marketplace add <absolute-path-to-this-repo>
/plugin install scaffold-skill@scaffold-skill

As a Codex plugin

codex plugin marketplace add backnotprop/scaffold-skill
codex plugin add scaffold-skill@scaffold-skill

Skill

• scaffold-skill — write, update, validate, and optionally package Agent Skills in repositories.

Repository shape

skills/scaffold-skill/SKILL.md
skills/scaffold-skill/agents/openai.yaml
skills/scaffold-skill/references/
skills/scaffold-skill/scripts/
skills.sh.json
.claude-plugin/plugin.json
.claude-plugin/marketplace.json
.codex-plugin/plugin.json
.agents/plugins/marketplace.json

Verification

The skill includes optional scripts for source-backed reference maintenance and skill validation.

Maintain scaffold-skill's own references against local spec/CLI checkouts:

python3 skills/scaffold-skill/scripts/verify_reference_facts.py

Validate this publishable meta-repo (it has plugin manifests and skills.sh.json):

python3 skills/scaffold-skill/scripts/validate_skill_repo.py . \
  --targets vercel,claude,codex \
  --strict-frontmatter

When scaffolding a skill inside another repo, validate only what you created. For a project-local skill, prefer:

python3 skills/scaffold-skill/scripts/validate_skill_repo.py <repo-root> --strict-frontmatter

If reference source repos are not auto-discovered, pass explicit paths with --agentskills <path>, --vercel-skills <path>, and repeatable --production-repo <path>.