skill-upgrader

Skill Upgrader

Meta-skill that upgrades any SKILL.md to Decision Theory v5 Hybrid format using 4 parallel Ragie-backed agents.

When to Use

• "Upgrade this skill to v5"
• "Formalize this skill with decision theory"
• "Add MDP structure to this skill"
• "Apply the skill-upgrader to X"

Prerequisites

Ragie RAG with indexed books:

• decision-theory partition: LaValle Planning Algorithms, Sutton & Barto RL
• modal-logic partition: Blackburn Modal Logic, Huth & Ryan Logic in CS

Workflow

Step 1: Setup Session

SESSION=$(date +%Y%m%d-%H%M%S)-upgrade-{skill_name}
mkdir -p thoughts/skill-builds/${SESSION}

Step 2: Initialize Blackboard

Create thoughts/skill-builds/{session}/00-blackboard.md:

# Skill Upgrade: {skill_name}
Started: {timestamp}

## Input Skill
{path_to_skill}

## Target Format
Decision Theory v5 Hybrid

## Agent Findings
(Agents append below)

---

Step 3: Launch 4 Agents in Parallel

Use Task tool to spawn all 4 agents simultaneously. Each agent:

1. Reads the input skill
2. Queries Ragie for their specific book
3. Appends findings to the blackboard

Agent 1: LaValle Planner

Book: LaValle's "Planning Algorithms" (decision-theory partition) Focus: States, Actions, Transitions

Task(
  subagent_type="general-purpose",
  prompt="""
INPUT SKILL: {path}
BLACKBOARD: thoughts/skill-builds/{session}/00-blackboard.md

YOUR BOOK: LaValle's "Planning Algorithms" in Ragie partition 'decision-theory'

TASK: Identify MDP structure in the skill.

Query Ragie:
```bash
uv run python scripts/ragie_query.py -q "MDP state space definition" -p decision-theory
uv run python scripts/ragie_query.py -q "action space sequential decisions" -p decision-theory
uv run python scripts/ragie_query.py -q "POMDP partial observability" -p decision-theory

Read the input skill and answer:

1. What are the STATES? (phases, modes, tracked info)
2. What are the ACTIONS? (what can agent do in each state)
3. How do TRANSITIONS work? (deterministic or stochastic)
4. Is this POMDP or fully observable?

WRITE to blackboard section: ## Agent 1: States, Actions & Transitions

Format as plain English with LaValle chapter citations. """ )