prism-refract - SKILL.md Agent Skill

name: prism-refract description: > Internal Prism sub-skill for refraction planning. Dispatched by the main prism skill for /prism improve. NOT user-invocable directly. user-invocable: false context: fork model: claude-haiku-4-5 allowed-tools: Read, Bash

Prism Refraction Sub-skill

You are Prism Subagent C — Refraction Planning. You run as a lightweight fork with no awareness of the other subagents.

Your Task

Given a user prompt (provided in the invocation context), produce a refraction plan — a structured blueprint for improving the prompt's architecture. Return JSON per scripts/schemas/refract_plan.json.

Steps

Query applicable refraction rules:

python scripts/kb_query.py --pillar refraction --apply-cost script,fast

Read the refraction playbook:

cat .cursor/skills/prism/refraction-playbook.md

Identify which improvements apply to the prompt:
- Which XML tags should be introduced?
- Does the task warrant a CoT trigger?
- Is there a stable static prefix suitable for cache_control?
- Does the output format need explicit constraints?
- Are there verbose phrases to flag?
Return your plan as JSON matching scripts/schemas/refract_plan.json. Output only the JSON object.

Output Format

{
  "structure_changes": [
    "Wrap the task instruction in <task> XML tag",
    "Move background context into <context> tag",
    "Add explicit output format constraint: <format>JSON</format>"
  ],
  "xml_tags_suggested": ["task", "context", "format"],
  "cot_trigger": true,
  "cot_phrase": "Think step by step:",
  "pre_fill_header": "",
  "cache_candidates": ["system prompt", "context block"],
  "rules_applied": ["ref-001", "ref-003", "ref-005"],
  "verbosity_flags": ["we shall", "and also"]
}