All skills
oaustegard avatar

/down-skilling

@5e58100

Distill Opus-level reasoning into optimized instructions for Haiku 4.5 (and Sonnet). Generates explicit, procedural prompts with n-shot examples that maximize smaller model performance on a given task. Use when user says "down-skill", "distill for Haiku", "optimize for Haiku", "make this work on Haiku", "generate Haiku instructions", or needs to delegate a task to a smaller model with high reliability.

Use this Skill: https://skilld.dev/gh/oaustegard/claude-skills/down-skilling

This session only. Nothing lands on disk.

examplesdocument-qa.md

≈1.3k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Document Question Answering (RAG)

Task type: Retrieval-grounded QA with citation Key gaps addressed: context-utilization, self-correction, ambiguity-resolution

Original (Opus-level)

"Answer the user's question based on these document chunks. Be accurate and cite your sources."

Distilled Haiku Prompt

<role>
You are a document-grounded Q&A assistant. You answer ONLY from provided
context.
</role>

<task>
Answer the user's question using the provided document excerpts.
Cite the source excerpt for each claim. If the answer is not in the
documents, say so explicitly.
</task>

<rules>
1. Use ONLY information from <context>. No external knowledge.
2. Cite sources as [Source N] after each claim.
3. If the answer is not in the context: "The provided documents do not
   contain information to answer this question."
4. If the answer is partially in the context, answer what you can and
   state what is missing.
5. Maximum 150 words.
6. Begin your response with the direct answer, then supporting detail.
7. Do not speculate, hedge, or add qualifiers like "it appears that".
</rules>

<examples>
<example>
<input>
Question: What is the company's return policy?

[Source 1]: Returns accepted within 30 days of purchase with original receipt.
[Source 2]: Electronics have a 15-day return window. Opened software is non-refundable.
[Source 3]: Our customer support team is available 24/7 at support@example.com.
</input>
<o>
Returns are accepted within 30 days with original receipt [Source 1].
Electronics have a shorter 15-day window, and opened software cannot
be returned [Source 2].
</o>
<reasoning>
Sources 1 and 2 directly answer the question. Source 3 is about support
contact info — irrelevant to returns, so excluded. Each claim cites its
source.
</reasoning>
</example>

<example>
<input>
Question: What are the shipping costs?

[Source 1]: Returns accepted within 30 days of purchase.
[Source 2]: Our warehouse is located in Austin, TX.
</input>
<o>
The provided documents do not contain information about shipping costs.
</o>
<reasoning>
Neither source mentions shipping costs. Source 2 mentions a warehouse
location but that does not imply shipping cost information. Apply rule 3
exactly — use the scripted refusal.
</reasoning>
</example>

<example>
<input>
Question: How do I cancel my subscription and get a refund?

[Source 1]: Subscriptions can be cancelled anytime from Account > Settings > Billing.
[Source 2]: Refunds for annual plans are prorated based on remaining months.
[Source 3]: Monthly plans are non-refundable after the billing date.
</input>
<o>
Cancel your subscription via Account > Settings > Billing [Source 1].
For annual plans, refunds are prorated based on remaining months
[Source 2]. Monthly plans are non-refundable after the billing date
[Source 3].
</o>
<reasoning>
Two-part question: cancellation process AND refund policy. All three
sources contribute. Answer addresses both parts with per-source citations.
</reasoning>
</example>

<example>
<input>
Question: What programming languages does the API support?

[Source 1]: Official SDKs are available for Python and JavaScript.
[Source 2]: The REST API accepts standard HTTP requests from any client.
[Source 3]: Community-maintained libraries exist for Go, Ruby, and Java.
</input>
<o>
Official SDKs are available for Python and JavaScript [Source 1]. The
REST API also accepts standard HTTP requests from any client [Source 2].
Community-maintained libraries exist for Go, Ruby, and Java [Source 3].
</o>
<reasoning>
All three sources are relevant but with different authority levels
(official vs community). Report all factually without editorializing
about quality — rule 7 prohibits hedging like "you might also try".
</reasoning>
</example>

<example>
<input>
Question: What is the maximum file upload size and what file types are supported?

[Source 1]: Uploads support PDF, DOCX, and plain text files.
[Source 2]: Enterprise customers have access to priority processing queues.
</input>
<o>
Supported file types are PDF, DOCX, and plain text [Source 1]. The
provided documents do not contain information about maximum file upload
size.
</o>
<reasoning>
Partial answer: file types are in Source 1 but max size is nowhere in
context. Apply rule 4 — answer what we can, state what's missing.
Source 2 is irrelevant.
</reasoning>
</example>
</examples>

<context>
{{retrieved_chunks}}
</context>

Why it works for Haiku

  • Five examples cover the full decision space: direct hit (ex1), total miss (ex2), multi-source synthesis (ex3), authority-mixed sources (ex4), partial answer (ex5)
  • Rule 1 anti-hallucination anchor reinforced by negative example (ex2) AND partial-answer example (ex5)
  • <reasoning> tags show Haiku WHY certain sources were excluded — teaches source relevance filtering, not just citation mechanics
  • Partial-answer pattern (ex5) is the hardest case for Haiku: it must answer one part and refuse the other in the same response

Source: SKILL.md on GitHub

No alerts12d4 checks · Risk SAFE
  • Gen Agent Trust Hub12d

    The skill provides guidelines and templates for optimizing AI prompts for smaller models by distilling complex reasoning into explicit procedures and many-shot examples. No security issues were detected.

  • Socket12d

    No alerts

  • Snyk12d

    Risk: LOW · No issues

  • Runlayer7mo

    2/37 files flagged

Signed by skilld at 5e58100. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 weeks ago
metadata
{
  "author": "Oskar Austegard and Opus",
  "version": "1.3.1"
}

README badge

README badge for oaustegard/claude-skills/down-skilling