personal-mcp MCP Usage

This repository is resource-first.

Canonical skill guidance lives in src/personal_mcp/docs/skills/<skill-id>/SKILL.md.
Skills are exposed through FastMCP's native skill:// resource family.
Prompts are exposed through native MCP prompt operations (prompts/list, prompts/get).
General documentation pages are exposed through resource://docs/{path*}.
The server intentionally does not provide compatibility tool projections for resources or prompts.

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

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

Preferred MCP resource order:

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 tool projections for resource or prompt access.

Python Checks

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

uv run ruff check .

uv run ty check

uv run pytest