skill-scaffold

Teach your AI agent how your project works — once.

The Problem

Every time you chat with AI in Cursor, it starts from zero. It doesn't know your naming conventions, your component patterns, or how you write tests. So you repeat yourself. Every. Single. Time.

skill-scaffold fixes this. It reads your codebase and generates a set of convention files (AGENTS.md) and skills (SKILL.md) that give the AI full context about your project. After setup, the AI follows your patterns automatically.

Setup (3 commands)

/skill-scaffold --init       ← foundation: .cursorignore + prebuilt skills
/skill-scaffold --agents     ← analyze codebase, create AGENTS.md convention files
/skill-scaffold --skills     ← generate project-specific skills

Install first

cp -r skills/skill-scaffold /path/to/your-project/.cursor/skills/skill-scaffold

Then open Cursor and run the 3 commands above in chat, one at a time.

Example

You: /skill-scaffold --init

AI: Created .cursorignore. Deployed prebuilt skills. Done.

You: /skill-scaffold --agents

AI: Detected Rails backend + Vue frontend. Created 12 AGENTS.md files. Look correct?

You: Yes

You: /skill-scaffold --skills

AI: Recommending: frontend, backend, test, apply, reviewer, pr-description. Generate all?

You: All.

AI: Done. 6 skills generated.

Now use them:

/apply add user settings page — AI implements using your patterns

/reviewer — AI reviews code from multiple domain perspectives

/pr-description — AI generates PR description from your git diff

What Gets Created

your-project/
├── AGENTS.md                         ← project conventions (root)
├── app/
│   ├── models/AGENTS.md              ← module-level conventions
│   ├── services/AGENTS.md
│   └── ...
└── .cursor/skills/
    ├── frontend/SKILL.md             ← your frontend patterns
    ├── backend/SKILL.md              ← your backend patterns
    ├── test/SKILL.md                 ← your test conventions
    ├── apply/SKILL.md                ← implementation coordinator
    ├── reviewer/SKILL.md             ← code review
    ├── pr-description/SKILL.md       ← PR description generator
    ├── brainstorming/SKILL.md        ← structured ideation
    └── ...

• AGENTS.md — describes your conventions per directory. AI reads these to understand patterns.
• SKILL.md — gives AI specialized capabilities (implement, review, brainstorm, etc.)

Learn More

Topic	Link
All available skills and what they do	docs/available-skills.md
Updating and creating custom skills	docs/updating-skills.md
Full commands reference	docs/commands.md
How it works under the hood	docs/how-it-works.md

License

MIT