From 3df24f84713f84b341a2c435dc8b07aaa35a07a1 Mon Sep 17 00:00:00 2001 From: Peter Nicholls Date: Sat, 10 Jan 2026 21:34:20 +0000 Subject: [PATCH 1/3] Add PaperKit Copilot skills --- .github/skills/paperkit-defaults/SKILL.md | 23 ++++++++++++++++++++ .github/skills/paperkit-routing/SKILL.md | 26 +++++++++++++++++++++++ .paperkit/docs/skills.md | 20 +++++++++++++++++ 3 files changed, 69 insertions(+) create mode 100644 .github/skills/paperkit-defaults/SKILL.md create mode 100644 .github/skills/paperkit-routing/SKILL.md create mode 100644 .paperkit/docs/skills.md diff --git a/.github/skills/paperkit-defaults/SKILL.md b/.github/skills/paperkit-defaults/SKILL.md new file mode 100644 index 0000000..ae76ca6 --- /dev/null +++ b/.github/skills/paperkit-defaults/SKILL.md @@ -0,0 +1,23 @@ +--- +name: paperkit-defaults +description: Apply default PaperKit workflow settings like citation style, output folders, and document class. +--- + +## Defaults +Use these defaults unless the user specifies otherwise: + +- Citation style: harvard +- Document class: article +- Target audience: academic +- Standards flexibility: pragmatic + +## Paths +Assume these default paths (relative to project root): + +- Paper folder: .paper +- Output folder: .paperkit/data +- LaTeX folder: latex +- Planning folder: planning + +## Usage notes +If a request conflicts with these defaults, prioritize the user's instruction and call out the override. diff --git a/.github/skills/paperkit-routing/SKILL.md b/.github/skills/paperkit-routing/SKILL.md new file mode 100644 index 0000000..f46d67b --- /dev/null +++ b/.github/skills/paperkit-routing/SKILL.md @@ -0,0 +1,26 @@ +--- +name: paperkit-routing +description: Route PaperKit requests to the right agent module using the orchestrator tie-break rules. +--- + +## Purpose +Use this skill when a request needs routing to a single PaperKit agent. + +## Routing rules +Select exactly one agent and do not perform the task yourself. Use these tie-break rules: + +- "peer reviewed / cited by / discredited / provenance / credibility" -> librarian +- "help me understand / explain / distil / teach" -> tutor +- "derive / implement / debug / algorithm / model" -> problem-solver +- "harvard / bibtex / biblatex / biber / citations / doi" -> reference-manager +- "latex compile / .tex error / package / build log" -> latex-assembler +- "outline / structure / argument flow" -> paper-architect +- "draft section / write introduction/methods/related work" -> section-drafter +- "polish / rewrite / tighten" -> quality-refiner +- otherwise: research-consolidator (if synthesis) or brainstorm (if ideation) + +## Output requirements +When routing: +- Choose exactly one agent. +- Ask a clarifying question only when required inputs are missing. +- Do not fabricate citations, sources, quotes, or attribution. diff --git a/.paperkit/docs/skills.md b/.paperkit/docs/skills.md new file mode 100644 index 0000000..1ddf394 --- /dev/null +++ b/.paperkit/docs/skills.md @@ -0,0 +1,20 @@ +# PaperKit Agent Skills + +PaperKit exposes Copilot Agent Skills to make routing and defaults discoverable in tools that support skill injection. + +## Skills included + +### paperkit-routing +Use for routing PaperKit requests to a single agent based on the orchestrator tie-break rules. + +Source of truth: +- `.paperkit/core/agents/orchestrator.md` + +### paperkit-defaults +Use to apply PaperKit workflow defaults like citation style, output folders, and document class. + +Source of truth: +- `.paperkit/core/config.yaml` + +## Locations +Project skills are located under `.github/skills/`. From 30ce588128340c9a0729604ee20e90471a0c63bb Mon Sep 17 00:00:00 2001 From: Peter Nicholls Date: Sat, 10 Jan 2026 21:36:19 +0000 Subject: [PATCH 2/3] Update .github/skills/paperkit-routing/SKILL.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- .github/skills/paperkit-routing/SKILL.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/.github/skills/paperkit-routing/SKILL.md b/.github/skills/paperkit-routing/SKILL.md index f46d67b..41b112c 100644 --- a/.github/skills/paperkit-routing/SKILL.md +++ b/.github/skills/paperkit-routing/SKILL.md @@ -17,7 +17,9 @@ Select exactly one agent and do not perform the task yourself. Use these tie-bre - "outline / structure / argument flow" -> paper-architect - "draft section / write introduction/methods/related work" -> section-drafter - "polish / rewrite / tighten" -> quality-refiner -- otherwise: research-consolidator (if synthesis) or brainstorm (if ideation) +- "synthesize / summarize / consolidate" -> research-consolidator +- "brainstorm / ideate / suggest" -> brainstorm +- otherwise: research-consolidator ## Output requirements When routing: From 6e7ef9112224367fac18c81d3569908c8f0bd17e Mon Sep 17 00:00:00 2001 From: Peter Nicholls Date: Sat, 10 Jan 2026 21:36:27 +0000 Subject: [PATCH 3/3] Update .paperkit/docs/skills.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- .paperkit/docs/skills.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.paperkit/docs/skills.md b/.paperkit/docs/skills.md index 1ddf394..a5dd130 100644 --- a/.paperkit/docs/skills.md +++ b/.paperkit/docs/skills.md @@ -8,13 +8,13 @@ PaperKit exposes Copilot Agent Skills to make routing and defaults discoverable Use for routing PaperKit requests to a single agent based on the orchestrator tie-break rules. Source of truth: -- `.paperkit/core/agents/orchestrator.md` +- [.paperkit/core/agents/orchestrator.md](../core/agents/orchestrator.md) ### paperkit-defaults Use to apply PaperKit workflow defaults like citation style, output folders, and document class. Source of truth: -- `.paperkit/core/config.yaml` +- [.paperkit/core/config.yaml](../core/config.yaml) ## Locations Project skills are located under `.github/skills/`.