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..41b112c --- /dev/null +++ b/.github/skills/paperkit-routing/SKILL.md @@ -0,0 +1,28 @@ +--- +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 +- "synthesize / summarize / consolidate" -> research-consolidator +- "brainstorm / ideate / suggest" -> brainstorm +- otherwise: research-consolidator + +## 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..a5dd130 --- /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](../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](../core/config.yaml) + +## Locations +Project skills are located under `.github/skills/`.