diff --git a/.github/instructions/skill-authoring.instructions.md b/.github/instructions/skill-authoring.instructions.md new file mode 100644 index 0000000..717b15a --- /dev/null +++ b/.github/instructions/skill-authoring.instructions.md @@ -0,0 +1,17 @@ +--- +name: Skill Authoring +description: "Use when creating or editing skills under src/personal_mcp/docs/skills/. Enforces the Agent Skills specification and FastMCP skill provider compatibility." +applyTo: 'src/personal_mcp/docs/skills/**' +--- + +# Skill Authoring + +Before editing files under `src/personal_mcp/docs/skills/`, consult all of these references: + +- [Agent Skills quickstart](https://agentskills.io/skill-creation/quickstart) +- [Agent Skills best practices](https://agentskills.io/skill-creation/best-practices) +- [FastMCP skill providers](https://gofastmcp.com/servers/providers/skills) + +Treat each immediate subdirectory of `src/personal_mcp/docs/skills/` as an independent Agent Skill. Keep its structure and content compliant with the Agent Skills pattern and compatible with the FastMCP skill provider. + +Reconcile the external guidance with the repository's existing skill conventions and contracts before making changes. \ No newline at end of file