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

# New Skill Bootstrap

Use this skill to bootstrap a new skill in the docs-first architecture.

## 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.

## Authoring Checklist

1. Create docs/skills/<skill-id>/SKILL.md.
2. Add docs/skills/<skill-id>/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/<skill-id>/document in capabilities.

## Validation

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