From f1dd6ab940ffac570811c1428d2140ff7ce86705 Mon Sep 17 00:00:00 2001
From: John Lancaster <32917998+jsl12@users.noreply.github.com>
Date: Thu, 27 Aug 2026 17:20:16 -0500
Subject: [PATCH] skill authoring

---
 .../skill-authoring.instructions.md             | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 .github/instructions/skill-authoring.instructions.md

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