# 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
```bash
npx skills add backnotprop/scaffold-skill
```
List available skills first:
```bash
npx skills add backnotprop/scaffold-skill --list
```
Install globally:
```bash
npx skills add backnotprop/scaffold-skill -g -y
```
Install from a local checkout:
```bash
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
```text
/plugin marketplace add backnotprop/scaffold-skill
/plugin install scaffold-skill@scaffold-skill
```
Local checkout:
```text
/plugin marketplace add <absolute-path-to-this-repo>
/plugin install scaffold-skill@scaffold-skill
```
### As a Codex plugin
```bash
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
```text
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:
```bash
python3 skills/scaffold-skill/scripts/verify_reference_facts.py
```
Validate **this** publishable meta-repo (it has plugin manifests and `skills.sh.json`):
```bash
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:
```bash
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>`.