prompts/docs/skills/new-skill/SKILL.md

name, description, argument-hint, x-personal-mcp

name	description	argument-hint	x-personal-mcp
new-skill	Provide a practical checklist and baseline template for creating a new docs-first MCP skill in this repository.	What skill are you creating, and what problem should it solve?	id version tags capabilities depends_on references new-skill 1.0.0 fastmcp bootstrap scaffolding skills mcp resource://skills/new-skill/document

New Skill Bootstrap

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//.
2. Define SKILL frontmatter with Anthropic and x-personal-mcp fields.
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

1. Create docs/skills//SKILL.md.
2. Add docs/skills//references/ files as needed.
3. Keep skill id and directory name aligned.
4. Keep frontmatter name equal to x-personal-mcp.id.
5. Include resource://skills//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

1. uv run zensical build
2. uv run pytest -q