prompts/.github/copilot-instructions.md

personal-mcp MCP Usage

This repository is resource-first.

• Canonical skill guidance lives in docs/skills/<skill-id>/SKILL.md.
• The machine-facing skill contract is FastMCP's native skill:// resource family.

When a task appears to match a documented implementation pattern in personal-mcp, use this sequence:

1. Prefer an already attached native skill resource.
2. Otherwise browse native MCP resources and compare skill://<name>/SKILL.md descriptions.
3. Read the best matching main skill file, or at most 2 candidate main files.
4. Read skill://<name>/_manifest only when supporting material may be useful.
5. Fetch only the relevant supporting paths from that manifest.
6. Reconcile skill guidance with the actual repository code before proposing or making changes.

Preferred MCP resource order:

1. skill://<name>/SKILL.md
2. skill://<name>/_manifest when needed
3. skill://<name>/<supporting-path> for selected supporting files

Selection rules:

• Prefer the closest name and description match.
• Keep context bounded; do not load many skill documents speculatively.
• If confidence is low after reading at most two main files, ask one clarifying question before loading more context.

Repository-specific guidance:

• For tasks about adding or modifying a skill, use skill://copilot-customization/SKILL.md when relevant.
• Keep skills provider-native; do not add custom skill catalogs, per-skill resource modules, or skill-specific discovery tools.

Python Checks

After changes run these commands to confirm functionality. Resolve any errors

uv run ruff check

uv run ty check

uv run pytest