shihabshahrier/skill-builder
Build & audit AI agent skills from plain English
Actual rules from this repo
Path in source repo: .cursor/rules/skill-builder.mdc · format: mdc
---
description: "skill-builder — build or audit any AI agent skill from a description when user invokes /skill-builder"
alwaysApply: false
---
When user says `/skill-builder`, follow `skills/skill-builder/SKILL.md`.
**Invocation**: `/skill-builder "description" [--type workflow|mode|tool|reference|agent] [--repo] [--audit path] [--fix]`
**Phases (create)**:
0. Route — detect --audit; if present jump to Phase A
1. Classify skill type (auto-detect or --type)
2. Gather requirements (≤3 questions total)
3. Domain research — WebSearch official docs (skip if no references needed)
4. Generate SKILL.md (frontmatter + body for type)
5. Generate references/ (verified facts only)
6. Generate hooks/ (mode skills only)
7. Scaffold full repo (--repo only)
8. Report + install commands
**Phase A (--audit)**:
1. Read SKILL.md at path
2. Run quality checklist from `references/skill-anatomy.md`
3. Output audit report: failures / warnings / passed
4. If --fix: output corrected SKILL.md (fix failures only)
**Critical**:
- `name`: `^[a-z0-9]+(-[a-z0-9]+)*$`, max 64 chars
- `description`: max 1024 chars; SKILL.md body: max 5000 tokens
- Domain facts in references: WebSearch official docs — never guess
- Reference files >100 lines: TOC at top; one-level-deep only
Why this is listed
This repository appears on Cursor Rules Live because it matches the tracker's GitHub Search criteria (cursor-rules) and was active in the recent indexing window. The tracker refreshes every 15 minutes, so the metadata above reflects the state at the most recent index pass. If the data here looks stale, the source repository may have been archived or moved out of the tracked topic; the next cron tick will reconcile.