@taskclan/achilleon 0.3.0 → 0.4.0

package/README.md

@@ -10,9 +10,9 @@ Three kinds of entries live in this repo:
 
 | Kind | What it is | Where it runs |
 |---|---|---|
-| **Skill** | A single slash command with a fixed system prompt and tier binding | Inside `@taskclan` on the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=taskclan.taskclan-intelligence) and (eventually) the CLI + web playground |
-| **Agent** | A named chat participant with a locked personality (`@taskclan-reviewer`, `@taskclan-guru`, ...) | VS Code chat |
-| **Prompt** | A parameterised prompt template loaded by key from the Taskclan SDK | Anywhere the SDK runs |
+| **Skill** | A single slash command with a fixed system prompt and tier binding | Inside `@taskclan` on the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=taskclan.taskclan-intelligence), Cursor / Continue / Claude Code (via `dist/*` bundles), or anywhere else you can paste a prompt |
+| **Agent** | A named chat participant with a locked personality (`@taskclan-reviewer`, `@taskclan-guru`, ...) | VS Code chat via the extension; also exportable as Cursor / Continue slash commands |
+| **Prompt** | A parameterised template with `{{variables}}` — you fill in values at call time | Any SDK consumer via `render()` from `@taskclan/achilleon`. Ships with helpers for `summarize`, `translate`, `extract`, `classify`, `judge`, `refine`. |
 
 ## Directory shape
 
@@ -110,6 +110,44 @@ Skills are also emitted as plain markdown you can paste into any system-prompt /
     # Or grab one
     curl -O https://raw.githubusercontent.com/taskclan/achilleon/main/dist/raw/debug.md
 
+### npm — for SDK / tooling authors
+
+If you are building your own tool and want the registry as typed data:
+
+    npm install @taskclan/achilleon
+
+```ts
+import { skills, agents, prompts, render, getSkill, byTier, categories } from '@taskclan/achilleon';
+
+// Every skill and agent, typed.
+for (const s of skills) {
+  console.log(s.id, s.tier, s.description);
+}
+
+// One entry by id.
+const debug = getSkill('debug');
+console.log(debug?.system);
+
+// Group by tier.
+const heavyReasoners = byTier('t1-max');
+
+// Render a parameterised prompt template.
+const filled = render('summarize', {
+  text: articleBody,
+  length: '5 bullets',
+});
+// filled is now a full prompt string — hand it to any LLM.
+```
+
+CJS also works: `const { skills } = require('@taskclan/achilleon')`.
+
+Raw JSON is also directly importable:
+
+```ts
+import registry from '@taskclan/achilleon/registry';
+// { skills: AchilleonSkill[], agents: AchilleonAgent[] }
+```
+
 ### Taskclan Intelligence VS Code extension (first-party)
 
 If you install [`taskclan.taskclan-intelligence`](https://marketplace.visualstudio.com/items?itemName=taskclan.taskclan-intelligence) from the VS Code Marketplace, you get every skill wired as `@taskclan /<name>` with T1 routing baked in. The extension pulls Achilleon at build time so new entries land in the next release automatically.

package/dist/index.cjs

@@ -5,15 +5,35 @@ const registry = JSON.parse(readFileSync(join(__dirname, 'registry.json'), 'utf8
 
 const skills = registry.skills;
 const agents = registry.agents;
+const prompts = registry.prompts;
 const entries = [...registry.agents, ...registry.skills];
 
+function _render(id, values, prompts) {
+  const p = prompts.find((x) => x.id === id);
+  if (!p) throw new Error('achilleon: prompt "' + id + '" not found');
+  const provided = values || {};
+  const used = new Set();
+  const output = p.template.replace(/\{\{\s*([a-z][a-z_0-9]{0,39})\s*\}\}/g, (_, name) => {
+    used.add(name);
+    if (provided[name] !== undefined && provided[name] !== null) return String(provided[name]);
+    const varDef = (p.variables || []).find((v) => v.name === name);
+    if (varDef && varDef.default !== undefined) return varDef.default;
+    if (varDef && varDef.required === false) return '';
+    throw new Error('achilleon: prompt "' + id + '" missing required variable "' + name + '"');
+  });
+  return output;
+}
+
 module.exports = {
   skills,
   agents,
+  prompts,
   entries,
   getSkill: (id) => skills.find((s) => s.id === id),
   getAgent: (id) => agents.find((a) => a.id === id),
   getEntry: (id) => entries.find((e) => e.id === id),
+  getPrompt: (id) => prompts.find((p) => p.id === id),
   categories: () => [...new Set(skills.map((s) => s.category))].sort(),
   byTier: (tier) => entries.filter((e) => e.tier === tier),
+  render: (id, values) => _render(id, values, prompts),
 };

package/dist/index.d.ts

@@ -44,13 +44,44 @@ export interface AchilleonAgent {
 
 export type AchilleonEntry = AchilleonSkill | AchilleonAgent;
 
+export interface AchilleonPromptVariable {
+  name: string;
+  description: string;
+  required?: boolean;
+  default?: string;
+}
+
+export interface AchilleonPrompt {
+  kind: 'prompt';
+  id: string;
+  name: string;
+  description: string;
+  template: string;
+  variables?: AchilleonPromptVariable[];
+  tier?: SkillTier;
+  author?: string;
+  version?: string;
+  tags?: string[];
+}
+
 export const skills: AchilleonSkill[];
 export const agents: AchilleonAgent[];
+export const prompts: AchilleonPrompt[];
 /** Agents first, then skills, in the order they were loaded. */
 export const entries: AchilleonEntry[];
 
 export function getSkill(id: string): AchilleonSkill | undefined;
 export function getAgent(id: string): AchilleonAgent | undefined;
 export function getEntry(id: string): AchilleonEntry | undefined;
+export function getPrompt(id: string): AchilleonPrompt | undefined;
 export function categories(): SkillCategory[];
 export function byTier(tier: SkillTier): AchilleonEntry[];
+
+/**
+ * Render a prompt template with values. Missing required variables throw;
+ * missing optional variables substitute the empty string.
+ *
+ *   import { render } from '@taskclan/achilleon';
+ *   const filled = render('summarize', { text: articleBody, length: '5 bullets' });
+ */
+export function render(id: string, values: Record<string, string | number | boolean>): string;

package/dist/index.mjs

@@ -4,11 +4,12 @@ import { dirname, join } from 'node:path';
 
 const HERE = dirname(fileURLToPath(import.meta.url));
 
-/** @type {{ skills: any[], agents: any[] }} */
+/** @type {{ skills: any[], agents: any[], prompts: any[] }} */
 const registry = JSON.parse(readFileSync(join(HERE, 'registry.json'), 'utf8'));
 
 export const skills = registry.skills;
 export const agents = registry.agents;
+export const prompts = registry.prompts;
 export const entries = [...registry.agents, ...registry.skills];
 
 export function getSkill(id) {
@@ -23,6 +24,10 @@ export function getEntry(id) {
   return entries.find((e) => e.id === id);
 }
 
+export function getPrompt(id) {
+  return prompts.find((p) => p.id === id);
+}
+
 /** All skill categories, sorted, unique. */
 export function categories() {
   return [...new Set(skills.map((s) => s.category))].sort();
@@ -32,3 +37,24 @@ export function categories() {
 export function byTier(tier) {
   return entries.filter((e) => e.tier === tier);
 }
+
+function _render(id, values, prompts) {
+  const p = prompts.find((x) => x.id === id);
+  if (!p) throw new Error('achilleon: prompt "' + id + '" not found');
+  const provided = values || {};
+  const used = new Set();
+  const output = p.template.replace(/\{\{\s*([a-z][a-z_0-9]{0,39})\s*\}\}/g, (_, name) => {
+    used.add(name);
+    if (provided[name] !== undefined && provided[name] !== null) return String(provided[name]);
+    const varDef = (p.variables || []).find((v) => v.name === name);
+    if (varDef && varDef.default !== undefined) return varDef.default;
+    if (varDef && varDef.required === false) return '';
+    throw new Error('achilleon: prompt "' + id + '" missing required variable "' + name + '"');
+  });
+  return output;
+}
+
+/** Render a prompt template with values. Missing required vars throw. */
+export function render(id, values) {
+  return _render(id, values, prompts);
+}

package/dist/prompts.json

@@ -0,0 +1,193 @@
+[
+  {
+    "kind": "prompt",
+    "id": "classify",
+    "name": "Classify into a fixed set",
+    "description": "Classify a piece of text into exactly one of a small set of labels. Returns just the label.",
+    "tier": "t1-core",
+    "author": "taskclan",
+    "version": "1.0.0",
+    "tags": [
+      "classification"
+    ],
+    "variables": [
+      {
+        "name": "text",
+        "description": "The text to classify.",
+        "required": true
+      },
+      {
+        "name": "labels",
+        "description": "Comma-separated list of allowed labels. E.g. \"billing, technical, refund, general\".",
+        "required": true
+      },
+      {
+        "name": "unknown_label",
+        "description": "The label to return when no other label fits. E.g. \"other\" or \"unknown\".",
+        "required": false,
+        "default": "unknown"
+      }
+    ],
+    "template": "Classify the text below into EXACTLY ONE of these labels:\n{{labels}}\n\nIf none fit, respond with: {{unknown_label}}\n\nRules:\n- Output the single label, lowercase, and NOTHING else.\n- No explanation, no punctuation, no code fences.\n\n--- TEXT ---\n{{text}}\n--- END ---\n"
+  },
+  {
+    "kind": "prompt",
+    "id": "extract",
+    "name": "Extract structured data",
+    "description": "Pull structured fields out of unstructured text into a JSON object matching the shape you describe.",
+    "tier": "t1-flow",
+    "author": "taskclan",
+    "version": "1.0.0",
+    "tags": [
+      "extraction",
+      "structured"
+    ],
+    "variables": [
+      {
+        "name": "text",
+        "description": "Unstructured source text.",
+        "required": true
+      },
+      {
+        "name": "shape",
+        "description": "Description of the JSON shape you want out. For example a TypeScript-style type such as \"name: string; email: string; company: string or null\".\n",
+        "required": true
+      },
+      {
+        "name": "strict",
+        "description": "If \"true\", missing fields become null. If \"false\", the model may infer plausible values from context.",
+        "required": false,
+        "default": "true"
+      }
+    ],
+    "template": "Read the source text below and extract a JSON object matching this shape:\n\n    {{shape}}\n\nRules:\n- Output ONLY the JSON object. No prose, no code fences, no commentary.\n- When strict={{strict}}: for missing fields, use null. Do not invent values.\n- If a value cannot be represented in the given shape, omit the entire object and output {\"_error\": \"reason\"} instead.\n\n--- SOURCE ---\n{{text}}\n--- END ---\n"
+  },
+  {
+    "kind": "prompt",
+    "id": "judge",
+    "name": "LLM as judge",
+    "description": "Evaluate an AI-generated answer against a question and a rubric. Returns a structured verdict.",
+    "tier": "t1-max",
+    "author": "taskclan",
+    "version": "1.0.0",
+    "tags": [
+      "eval",
+      "judge"
+    ],
+    "variables": [
+      {
+        "name": "question",
+        "description": "The original question or prompt the AI was answering.",
+        "required": true
+      },
+      {
+        "name": "answer",
+        "description": "The AI-generated answer to evaluate.",
+        "required": true
+      },
+      {
+        "name": "rubric",
+        "description": "Rubric describing what a good answer looks like. Can be a paragraph or a bulleted list.",
+        "required": true
+      }
+    ],
+    "template": "You are evaluating an AI-generated answer as a strict but fair judge.\nScore the answer against the rubric. Never side with the answer by\ndefault; look for real failures.\n\n--- QUESTION ---\n{{question}}\n--- END QUESTION ---\n\n--- ANSWER ---\n{{answer}}\n--- END ANSWER ---\n\n--- RUBRIC ---\n{{rubric}}\n--- END RUBRIC ---\n\nRespond with a JSON object exactly matching this shape (no prose):\n\n    {\n      \"verdict\": \"pass\" | \"fail\" | \"partial\",\n      \"score\": 0-10 integer,\n      \"reasoning\": \"one short paragraph\",\n      \"failures\": [\"specific issue 1\", \"specific issue 2\"]\n    }\n"
+  },
+  {
+    "kind": "prompt",
+    "id": "refine",
+    "name": "Refine text with feedback",
+    "description": "Rewrite a draft in response to specific feedback, preserving intent and unaffected sections.",
+    "tier": "t1-flow",
+    "author": "taskclan",
+    "version": "1.0.0",
+    "tags": [
+      "refine",
+      "editing"
+    ],
+    "variables": [
+      {
+        "name": "draft",
+        "description": "The current text to refine.",
+        "required": true
+      },
+      {
+        "name": "feedback",
+        "description": "The specific changes to apply. Can be a bulleted list or a paragraph.",
+        "required": true
+      },
+      {
+        "name": "preserve",
+        "description": "What must NOT change. E.g. \"keep all code snippets exactly as-is\", \"keep the ending paragraph\".",
+        "required": false,
+        "default": "keep everything not explicitly targeted by the feedback"
+      }
+    ],
+    "template": "Refine the draft below by applying the feedback. Follow these rules:\n\n1. Apply every piece of feedback that is actionable. If a feedback item\n   is unclear, note it in a one-line \"clarify:\" comment at the end and\n   skip it rather than guessing.\n2. Preserve: {{preserve}}\n3. Do not editorialise about the feedback. Output only the refined\n   version, followed by any clarify: comments.\n\n--- DRAFT ---\n{{draft}}\n--- END DRAFT ---\n\n--- FEEDBACK ---\n{{feedback}}\n--- END FEEDBACK ---\n"
+  },
+  {
+    "kind": "prompt",
+    "id": "summarize",
+    "name": "Summarize text",
+    "description": "Produce a tight, faithful summary of a body of text at a controllable length and altitude.",
+    "tier": "t1-flow",
+    "author": "taskclan",
+    "version": "1.0.0",
+    "tags": [
+      "summary",
+      "text"
+    ],
+    "variables": [
+      {
+        "name": "text",
+        "description": "The source text to summarise.",
+        "required": true
+      },
+      {
+        "name": "length",
+        "description": "Target length. One of \"one sentence\", \"one paragraph\", \"bulleted\", \"5 bullets\", \"detailed\".",
+        "required": false,
+        "default": "one paragraph"
+      },
+      {
+        "name": "audience",
+        "description": "Who the summary is for. Shapes altitude and jargon level. E.g. \"senior engineer\", \"non-technical exec\", \"10 year old\".",
+        "required": false,
+        "default": "general reader"
+      }
+    ],
+    "template": "Summarise the text below at length \"{{length}}\" for the audience \"{{audience}}\".\n\nRules:\n- Faithful to the source. Do not add facts.\n- Skip generic hedges like \"in conclusion\" or \"overall\".\n- If the source is empty or too short to summarise, say so and stop.\n\n--- SOURCE TEXT ---\n{{text}}\n--- END ---\n"
+  },
+  {
+    "kind": "prompt",
+    "id": "translate",
+    "name": "Translate text",
+    "description": "Translate text into a target language, preserving tone, formatting, and code fences.",
+    "tier": "t1-flow",
+    "author": "taskclan",
+    "version": "1.0.0",
+    "tags": [
+      "translation",
+      "i18n"
+    ],
+    "variables": [
+      {
+        "name": "text",
+        "description": "Source text.",
+        "required": true
+      },
+      {
+        "name": "target_language",
+        "description": "The target language. E.g. \"French\", \"Japanese\", \"Yoruba\", \"es-MX\".",
+        "required": true
+      },
+      {
+        "name": "tone",
+        "description": "Optional tone override. E.g. \"formal\", \"conversational\", \"technical documentation\".",
+        "required": false,
+        "default": "match the source tone"
+      }
+    ],
+    "template": "Translate the text below into {{target_language}}. Preserve tone\n(\"{{tone}}\"), formatting, and any code fences exactly. Never translate\ncontent inside code fences.\n\nIf a phrase has no faithful equivalent, translate for meaning and add\na one-line footnote at the very end explaining the choice.\n\n--- SOURCE ---\n{{text}}\n--- END ---\n"
+  }
+]

package/dist/registry.json

@@ -628,5 +628,198 @@
       ],
       "system": "You are the Taskclan sensei — a patient teacher in the Socratic\ntradition. You never give the answer directly. Every reply is a\nquestion that leads the student one step closer. When the student\nanswers correctly, confirm briefly and ask the next question. When\nthey get stuck, offer a smaller hint, still as a question. Only give\nthe direct answer if the student explicitly asks \"just tell me\" three\ntimes, and even then, follow the answer with \"what do you notice\nabout that?\".\n"
     }
+  ],
+  "prompts": [
+    {
+      "kind": "prompt",
+      "id": "classify",
+      "name": "Classify into a fixed set",
+      "description": "Classify a piece of text into exactly one of a small set of labels. Returns just the label.",
+      "tier": "t1-core",
+      "author": "taskclan",
+      "version": "1.0.0",
+      "tags": [
+        "classification"
+      ],
+      "variables": [
+        {
+          "name": "text",
+          "description": "The text to classify.",
+          "required": true
+        },
+        {
+          "name": "labels",
+          "description": "Comma-separated list of allowed labels. E.g. \"billing, technical, refund, general\".",
+          "required": true
+        },
+        {
+          "name": "unknown_label",
+          "description": "The label to return when no other label fits. E.g. \"other\" or \"unknown\".",
+          "required": false,
+          "default": "unknown"
+        }
+      ],
+      "template": "Classify the text below into EXACTLY ONE of these labels:\n{{labels}}\n\nIf none fit, respond with: {{unknown_label}}\n\nRules:\n- Output the single label, lowercase, and NOTHING else.\n- No explanation, no punctuation, no code fences.\n\n--- TEXT ---\n{{text}}\n--- END ---\n"
+    },
+    {
+      "kind": "prompt",
+      "id": "extract",
+      "name": "Extract structured data",
+      "description": "Pull structured fields out of unstructured text into a JSON object matching the shape you describe.",
+      "tier": "t1-flow",
+      "author": "taskclan",
+      "version": "1.0.0",
+      "tags": [
+        "extraction",
+        "structured"
+      ],
+      "variables": [
+        {
+          "name": "text",
+          "description": "Unstructured source text.",
+          "required": true
+        },
+        {
+          "name": "shape",
+          "description": "Description of the JSON shape you want out. For example a TypeScript-style type such as \"name: string; email: string; company: string or null\".\n",
+          "required": true
+        },
+        {
+          "name": "strict",
+          "description": "If \"true\", missing fields become null. If \"false\", the model may infer plausible values from context.",
+          "required": false,
+          "default": "true"
+        }
+      ],
+      "template": "Read the source text below and extract a JSON object matching this shape:\n\n    {{shape}}\n\nRules:\n- Output ONLY the JSON object. No prose, no code fences, no commentary.\n- When strict={{strict}}: for missing fields, use null. Do not invent values.\n- If a value cannot be represented in the given shape, omit the entire object and output {\"_error\": \"reason\"} instead.\n\n--- SOURCE ---\n{{text}}\n--- END ---\n"
+    },
+    {
+      "kind": "prompt",
+      "id": "judge",
+      "name": "LLM as judge",
+      "description": "Evaluate an AI-generated answer against a question and a rubric. Returns a structured verdict.",
+      "tier": "t1-max",
+      "author": "taskclan",
+      "version": "1.0.0",
+      "tags": [
+        "eval",
+        "judge"
+      ],
+      "variables": [
+        {
+          "name": "question",
+          "description": "The original question or prompt the AI was answering.",
+          "required": true
+        },
+        {
+          "name": "answer",
+          "description": "The AI-generated answer to evaluate.",
+          "required": true
+        },
+        {
+          "name": "rubric",
+          "description": "Rubric describing what a good answer looks like. Can be a paragraph or a bulleted list.",
+          "required": true
+        }
+      ],
+      "template": "You are evaluating an AI-generated answer as a strict but fair judge.\nScore the answer against the rubric. Never side with the answer by\ndefault; look for real failures.\n\n--- QUESTION ---\n{{question}}\n--- END QUESTION ---\n\n--- ANSWER ---\n{{answer}}\n--- END ANSWER ---\n\n--- RUBRIC ---\n{{rubric}}\n--- END RUBRIC ---\n\nRespond with a JSON object exactly matching this shape (no prose):\n\n    {\n      \"verdict\": \"pass\" | \"fail\" | \"partial\",\n      \"score\": 0-10 integer,\n      \"reasoning\": \"one short paragraph\",\n      \"failures\": [\"specific issue 1\", \"specific issue 2\"]\n    }\n"
+    },
+    {
+      "kind": "prompt",
+      "id": "refine",
+      "name": "Refine text with feedback",
+      "description": "Rewrite a draft in response to specific feedback, preserving intent and unaffected sections.",
+      "tier": "t1-flow",
+      "author": "taskclan",
+      "version": "1.0.0",
+      "tags": [
+        "refine",
+        "editing"
+      ],
+      "variables": [
+        {
+          "name": "draft",
+          "description": "The current text to refine.",
+          "required": true
+        },
+        {
+          "name": "feedback",
+          "description": "The specific changes to apply. Can be a bulleted list or a paragraph.",
+          "required": true
+        },
+        {
+          "name": "preserve",
+          "description": "What must NOT change. E.g. \"keep all code snippets exactly as-is\", \"keep the ending paragraph\".",
+          "required": false,
+          "default": "keep everything not explicitly targeted by the feedback"
+        }
+      ],
+      "template": "Refine the draft below by applying the feedback. Follow these rules:\n\n1. Apply every piece of feedback that is actionable. If a feedback item\n   is unclear, note it in a one-line \"clarify:\" comment at the end and\n   skip it rather than guessing.\n2. Preserve: {{preserve}}\n3. Do not editorialise about the feedback. Output only the refined\n   version, followed by any clarify: comments.\n\n--- DRAFT ---\n{{draft}}\n--- END DRAFT ---\n\n--- FEEDBACK ---\n{{feedback}}\n--- END FEEDBACK ---\n"
+    },
+    {
+      "kind": "prompt",
+      "id": "summarize",
+      "name": "Summarize text",
+      "description": "Produce a tight, faithful summary of a body of text at a controllable length and altitude.",
+      "tier": "t1-flow",
+      "author": "taskclan",
+      "version": "1.0.0",
+      "tags": [
+        "summary",
+        "text"
+      ],
+      "variables": [
+        {
+          "name": "text",
+          "description": "The source text to summarise.",
+          "required": true
+        },
+        {
+          "name": "length",
+          "description": "Target length. One of \"one sentence\", \"one paragraph\", \"bulleted\", \"5 bullets\", \"detailed\".",
+          "required": false,
+          "default": "one paragraph"
+        },
+        {
+          "name": "audience",
+          "description": "Who the summary is for. Shapes altitude and jargon level. E.g. \"senior engineer\", \"non-technical exec\", \"10 year old\".",
+          "required": false,
+          "default": "general reader"
+        }
+      ],
+      "template": "Summarise the text below at length \"{{length}}\" for the audience \"{{audience}}\".\n\nRules:\n- Faithful to the source. Do not add facts.\n- Skip generic hedges like \"in conclusion\" or \"overall\".\n- If the source is empty or too short to summarise, say so and stop.\n\n--- SOURCE TEXT ---\n{{text}}\n--- END ---\n"
+    },
+    {
+      "kind": "prompt",
+      "id": "translate",
+      "name": "Translate text",
+      "description": "Translate text into a target language, preserving tone, formatting, and code fences.",
+      "tier": "t1-flow",
+      "author": "taskclan",
+      "version": "1.0.0",
+      "tags": [
+        "translation",
+        "i18n"
+      ],
+      "variables": [
+        {
+          "name": "text",
+          "description": "Source text.",
+          "required": true
+        },
+        {
+          "name": "target_language",
+          "description": "The target language. E.g. \"French\", \"Japanese\", \"Yoruba\", \"es-MX\".",
+          "required": true
+        },
+        {
+          "name": "tone",
+          "description": "Optional tone override. E.g. \"formal\", \"conversational\", \"technical documentation\".",
+          "required": false,
+          "default": "match the source tone"
+        }
+      ],
+      "template": "Translate the text below into {{target_language}}. Preserve tone\n(\"{{tone}}\"), formatting, and any code fences exactly. Never translate\ncontent inside code fences.\n\nIf a phrase has no faithful equivalent, translate for meaning and add\na one-line footnote at the very end explaining the choice.\n\n--- SOURCE ---\n{{text}}\n--- END ---\n"
+    }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taskclan/achilleon",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Open registry of skills, agents, and prompts loaded by Taskclan Intelligence — and installable in Cursor, Continue.dev, Claude Code, Windsurf, Cline, Zed, or anywhere else you can paste a prompt. Contribute a YAML file to add or improve an entry.",
   "license": "MIT",
   "author": "Taskclan Inc.",
@@ -43,6 +43,8 @@
     "./skills.json": "./dist/skills.json",
     "./agents": "./dist/agents.json",
     "./agents.json": "./dist/agents.json",
+    "./prompts": "./dist/prompts.json",
+    "./prompts.json": "./dist/prompts.json",
     "./package.json": "./package.json"
   },
   "files": [
@@ -52,8 +54,10 @@
     "dist/registry.json",
     "dist/skills.json",
     "dist/agents.json",
+    "dist/prompts.json",
     "skills",
     "agents",
+    "prompts",
     "schema",
     "README.md",
     "LICENSE"

package/prompts/classify.yml

@@ -0,0 +1,32 @@
+id: classify
+name: Classify into a fixed set
+description: Classify a piece of text into exactly one of a small set of labels. Returns just the label.
+tier: t1-core
+author: taskclan
+version: 1.0.0
+tags:
+  - classification
+variables:
+  - name: text
+    description: The text to classify.
+    required: true
+  - name: labels
+    description: Comma-separated list of allowed labels. E.g. "billing, technical, refund, general".
+    required: true
+  - name: unknown_label
+    description: The label to return when no other label fits. E.g. "other" or "unknown".
+    required: false
+    default: unknown
+template: |
+  Classify the text below into EXACTLY ONE of these labels:
+  {{labels}}
+
+  If none fit, respond with: {{unknown_label}}
+
+  Rules:
+  - Output the single label, lowercase, and NOTHING else.
+  - No explanation, no punctuation, no code fences.
+
+  --- TEXT ---
+  {{text}}
+  --- END ---

package/prompts/extract.yml

@@ -0,0 +1,36 @@
+id: extract
+name: Extract structured data
+description: Pull structured fields out of unstructured text into a JSON object matching the shape you describe.
+tier: t1-flow
+author: taskclan
+version: 1.0.0
+tags:
+  - extraction
+  - structured
+variables:
+  - name: text
+    description: Unstructured source text.
+    required: true
+  - name: shape
+    description: >
+      Description of the JSON shape you want out.
+      For example a TypeScript-style type such as
+      "name: string; email: string; company: string or null".
+    required: true
+  - name: strict
+    description: If "true", missing fields become null. If "false", the model may infer plausible values from context.
+    required: false
+    default: "true"
+template: |
+  Read the source text below and extract a JSON object matching this shape:
+
+      {{shape}}
+
+  Rules:
+  - Output ONLY the JSON object. No prose, no code fences, no commentary.
+  - When strict={{strict}}: for missing fields, use null. Do not invent values.
+  - If a value cannot be represented in the given shape, omit the entire object and output {"_error": "reason"} instead.
+
+  --- SOURCE ---
+  {{text}}
+  --- END ---

package/prompts/judge.yml

@@ -0,0 +1,44 @@
+id: judge
+name: LLM as judge
+description: Evaluate an AI-generated answer against a question and a rubric. Returns a structured verdict.
+tier: t1-max
+author: taskclan
+version: 1.0.0
+tags:
+  - eval
+  - judge
+variables:
+  - name: question
+    description: The original question or prompt the AI was answering.
+    required: true
+  - name: answer
+    description: The AI-generated answer to evaluate.
+    required: true
+  - name: rubric
+    description: Rubric describing what a good answer looks like. Can be a paragraph or a bulleted list.
+    required: true
+template: |
+  You are evaluating an AI-generated answer as a strict but fair judge.
+  Score the answer against the rubric. Never side with the answer by
+  default; look for real failures.
+
+  --- QUESTION ---
+  {{question}}
+  --- END QUESTION ---
+
+  --- ANSWER ---
+  {{answer}}
+  --- END ANSWER ---
+
+  --- RUBRIC ---
+  {{rubric}}
+  --- END RUBRIC ---
+
+  Respond with a JSON object exactly matching this shape (no prose):
+
+      {
+        "verdict": "pass" | "fail" | "partial",
+        "score": 0-10 integer,
+        "reasoning": "one short paragraph",
+        "failures": ["specific issue 1", "specific issue 2"]
+      }

package/prompts/refine.yml

@@ -0,0 +1,37 @@
+id: refine
+name: Refine text with feedback
+description: Rewrite a draft in response to specific feedback, preserving intent and unaffected sections.
+tier: t1-flow
+author: taskclan
+version: 1.0.0
+tags:
+  - refine
+  - editing
+variables:
+  - name: draft
+    description: The current text to refine.
+    required: true
+  - name: feedback
+    description: The specific changes to apply. Can be a bulleted list or a paragraph.
+    required: true
+  - name: preserve
+    description: What must NOT change. E.g. "keep all code snippets exactly as-is", "keep the ending paragraph".
+    required: false
+    default: keep everything not explicitly targeted by the feedback
+template: |
+  Refine the draft below by applying the feedback. Follow these rules:
+
+  1. Apply every piece of feedback that is actionable. If a feedback item
+     is unclear, note it in a one-line "clarify:" comment at the end and
+     skip it rather than guessing.
+  2. Preserve: {{preserve}}
+  3. Do not editorialise about the feedback. Output only the refined
+     version, followed by any clarify: comments.
+
+  --- DRAFT ---
+  {{draft}}
+  --- END DRAFT ---
+
+  --- FEEDBACK ---
+  {{feedback}}
+  --- END FEEDBACK ---

package/prompts/summarize.yml

@@ -0,0 +1,32 @@
+id: summarize
+name: Summarize text
+description: Produce a tight, faithful summary of a body of text at a controllable length and altitude.
+tier: t1-flow
+author: taskclan
+version: 1.0.0
+tags:
+  - summary
+  - text
+variables:
+  - name: text
+    description: The source text to summarise.
+    required: true
+  - name: length
+    description: Target length. One of "one sentence", "one paragraph", "bulleted", "5 bullets", "detailed".
+    required: false
+    default: one paragraph
+  - name: audience
+    description: Who the summary is for. Shapes altitude and jargon level. E.g. "senior engineer", "non-technical exec", "10 year old".
+    required: false
+    default: general reader
+template: |
+  Summarise the text below at length "{{length}}" for the audience "{{audience}}".
+
+  Rules:
+  - Faithful to the source. Do not add facts.
+  - Skip generic hedges like "in conclusion" or "overall".
+  - If the source is empty or too short to summarise, say so and stop.
+
+  --- SOURCE TEXT ---
+  {{text}}
+  --- END ---

package/prompts/translate.yml

@@ -0,0 +1,31 @@
+id: translate
+name: Translate text
+description: Translate text into a target language, preserving tone, formatting, and code fences.
+tier: t1-flow
+author: taskclan
+version: 1.0.0
+tags:
+  - translation
+  - i18n
+variables:
+  - name: text
+    description: Source text.
+    required: true
+  - name: target_language
+    description: The target language. E.g. "French", "Japanese", "Yoruba", "es-MX".
+    required: true
+  - name: tone
+    description: Optional tone override. E.g. "formal", "conversational", "technical documentation".
+    required: false
+    default: match the source tone
+template: |
+  Translate the text below into {{target_language}}. Preserve tone
+  ("{{tone}}"), formatting, and any code fences exactly. Never translate
+  content inside code fences.
+
+  If a phrase has no faithful equivalent, translate for meaning and add
+  a one-line footnote at the very end explaining the choice.
+
+  --- SOURCE ---
+  {{text}}
+  --- END ---

package/schema/prompt.schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://taskclan.com/achilleon/schema/prompt.schema.json",
+  "title": "Achilleon Prompt",
+  "description": "A parameterised prompt template loaded by SDK consumers. Different from a skill (fixed system prompt for a slash command) — prompts take user-supplied values and render a final prompt string at call time. Lives at prompts/{id}.yml.",
+  "type": "object",
+  "required": ["id", "name", "description", "template"],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{1,39}$",
+      "description": "Lowercase, hyphen-separated. Must match the filename (without .yml). 2-40 characters."
+    },
+    "name": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 60,
+      "description": "Human-readable name shown in docs and pickers."
+    },
+    "description": {
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 200,
+      "description": "One-line description of what the prompt does."
+    },
+    "template": {
+      "type": "string",
+      "minLength": 20,
+      "maxLength": 8000,
+      "description": "The prompt body. Placeholders use {{variable}} syntax. Every placeholder must have a matching entry in `variables`; the validator enforces this."
+    },
+    "variables": {
+      "type": "array",
+      "maxItems": 20,
+      "items": {
+        "type": "object",
+        "required": ["name", "description"],
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "type": "string",
+            "pattern": "^[a-z][a-z_0-9]{0,39}$",
+            "description": "Variable name as it appears in the template ({{name}}). snake_case."
+          },
+          "description": {
+            "type": "string",
+            "minLength": 4,
+            "maxLength": 200,
+            "description": "What the variable is for. Shown in docs + used by SDK tooling."
+          },
+          "required": {
+            "type": "boolean",
+            "default": true,
+            "description": "If false, the SDK renderer allows omission (empty string is substituted)."
+          },
+          "default": {
+            "type": "string",
+            "description": "Default value substituted when a required variable is missing but a default is provided."
+          }
+        }
+      }
+    },
+    "tier": {
+      "type": "string",
+      "enum": ["t1-core", "t1-flow", "t1-max", "t1-auto"],
+      "description": "Recommended T1 tier this prompt runs well on. Consumers can override."
+    },
+    "author": {
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,38}[a-zA-Z0-9])?$"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$"
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 2, "maxLength": 30 },
+      "maxItems": 10,
+      "uniqueItems": true
+    }
+  }
+}