john/prompts
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

ruff skill

Browse Source
This commit is contained in:
John Lancaster
2026-06-20 17:25:47 -05:00
parent 660ca88e47
commit 0a9dadd5a8
8 changed files with 318 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/skills/new-skill/SKILL.md
+6 -3
View File
@@ -19,14 +19,15 @@ x-personal-mcp:
# New Skill Bootstrap
Use this skill to bootstrap a new skill in the docs-first architecture.
Use this skill to bootstrap a new skill in the docs-first architecture. Try to use the `/create-skill` where possible to structure the output, but place it alongside the other skills in this repo.
## Scope
1. Create docs under docs/skills/<skill-id>/.
2. Define SKILL frontmatter with Anthropic and x-personal-mcp fields.
3. Declare references via x-personal-mcp.references when needed.
4. Validate the docs build and MCP resource reads.
3. Treat top-level `references/*.md` as auto-discovered references with `ref-id` generated from filename.
4. Declare `x-personal-mcp.references` only when you need overrides or nested `references/**` entries.
5. Validate the docs build and MCP resource reads.
## Authoring Checklist
@@ -35,6 +36,8 @@ Use this skill to bootstrap a new skill in the docs-first architecture.
3. Keep skill id and directory name aligned.
4. Keep frontmatter name equal to x-personal-mcp.id.
5. Include resource://skills/<skill-id>/document in capabilities.
6. For each top-level `references/<name>.md`, expect `resource://skills/<skill-id>/references/<name>` (normalized to lowercase kebab-case).
7. Add explicit `x-personal-mcp.references` entries only for nested paths or metadata overrides.
## Validation