From 33144da02fc25175fa2532fce9cf584e9ae5f506 Mon Sep 17 00:00:00 2001
From: John Lancaster <32917998+jsl12@users.noreply.github.com>
Date: Sat, 20 Jun 2026 17:36:17 -0500
Subject: [PATCH] bootstrap prompt

---
 .github/prompts/skill-bootstrap.prompt.md | 12 +++++++++
 docs/skills/new-skill/SKILL.md            | 33 +++++++++++++++++++++++
 2 files changed, 45 insertions(+)
 create mode 100644 .github/prompts/skill-bootstrap.prompt.md

diff --git a/.github/prompts/skill-bootstrap.prompt.md b/.github/prompts/skill-bootstrap.prompt.md
new file mode 100644
index 0000000..9ea17d3
--- /dev/null
+++ b/.github/prompts/skill-bootstrap.prompt.md
@@ -0,0 +1,12 @@
+---
+name: New Skill Bootstrap
+description: Create and fully implement a new docs-first skill in this repository.
+argument-hint: skill-id and goal for the new skill
+agent: agent
+---
+
+# New Skill Bootstrap
+
+Use the canonical bootstrap guidance in [docs/skills/new-skill/SKILL.md](../../docs/skills/new-skill/SKILL.md).
+
+If the request is to create or implement a new skill, load that skill document and follow it as the source of truth.
\ No newline at end of file
diff --git a/docs/skills/new-skill/SKILL.md b/docs/skills/new-skill/SKILL.md
index caa3e24..d65dfe2 100644
--- a/docs/skills/new-skill/SKILL.md
+++ b/docs/skills/new-skill/SKILL.md
@@ -21,6 +21,23 @@ x-personal-mcp:
 
 Use this skill to bootstrap a new skill in the docs-first architecture. Try to use the `/create-skill` where possible to structure the output, but place it alongside the other skills in this repo.
 
+## Inputs
+
+1. New skill id (lowercase kebab-case)
+2. One-sentence capability statement (what it does and when to use it)
+3. Optional list of references to include under `references/`
+
+## Source of Truth and Required References
+
+1. Use this file as the baseline template for new skill authoring.
+2. Read and follow these docs before implementing a new skill:
+  - [docs/architecture.md](../../architecture.md)
+  - [docs/content.md](../../content.md)
+  - [docs/frontmatter.md](../../frontmatter.md)
+  - [docs/mcp_layout.md](../../mcp_layout.md)
+  - [docs/uris.md](../../uris.md)
+  - [docs/new_skill.md](../../new_skill.md)
+
 ## Scope
 
 1. Create docs under docs/skills/<skill-id>/.
@@ -39,7 +56,23 @@ Use this skill to bootstrap a new skill in the docs-first architecture. Try to u
 6. For each top-level `references/<name>.md`, expect `resource://skills/<skill-id>/references/<name>` (normalized to lowercase kebab-case).
 7. Add explicit `x-personal-mcp.references` entries only for nested paths or metadata overrides.
 
+## Required Outcomes
+
+1. Create `docs/skills/<skill-id>/SKILL.md` with valid frontmatter and a practical skill body.
+2. Create and populate `docs/skills/<skill-id>/references/` with any needed markdown references.
+3. Ensure frontmatter follows repository contract, including `x-personal-mcp` fields and canonical capabilities.
+4. Keep URI and reference mapping consistent with repository conventions.
+5. Reconcile all updates with repository implementation and avoid introducing parallel metadata systems.
+
 ## Validation
 
 1. uv run zensical build
 2. uv run pytest -q
+
+## Output Contract
+
+Return:
+
+1. Files created or updated
+2. Validation results
+3. Follow-up suggestions for improving the skill