功夫

Runtime Skill Synthesis Protocol

I KNOW KUNG FU

Transform your agents from completion-oriented tools into growth-oriented experts. IKKF distills your experience into your own sovereign, reusable skills — built from your work, for your setup, under your control. No third-party skill blobs you can't audit.

Beyond Completion

Solving the problem is only half the battle. Remembering how to solve it is the victory.

The Completion Fallacy

Most AI agents are optimized for the "Final Result." They execute a task, deliver the output, and then discard the process. This creates Knowledge Debt — the loss of expertise the moment a session is compacted or restarted.

The Synthesis Gate

IKKF introduces a hard systemic block: The Synthesis Gate. A task cannot be marked as complete until the agent distills the experience into a reusable SKILL.md. We transform "doing the work" into "building an expert system."

Sovereign by Default

Every skill is yours — generated from your own tasks, for your own workflow and setup. You can read, audit, and control every line. No opaque, externally-created skill that might be doing something you never approved. Your expertise stays yours.

Step 1/4
$ ikkf start "Build a trading screener"

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
✓ IKKF session started — no license required
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Phase 1/7: Decomposing goal...
Phase 2/7: Researching primitives...
IKKF is free forever. Full protocol, zero friction.

No license, no key, no machine-lock. Just run it.

Step 2/4
$ ikkf start "Build REST API in Go"

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ 🎯 AGENT ENGAGED — driving all 7 phases ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Domain: api | Research: normal
Phase 1: Acknowledged — IKKF protocol engaged
Phase 2: Domain — detected Go + WebSocket
Phase 3: Research — loading 2026 best practices...

IKKF automatically activates when confidence drops below your threshold.

Step 3/4
┏━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Chunk ┃ Time ┃ Task ┃ Status ┃
┡━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ 1/6 │ 12m │ Initialize Go module │ ✓ Done
│ 2/6 │ 18m │ Set up HTTP router │ ✓ Done
│ 3/6 │ — │ Implement handlers │ → Active
│ 4/6 │ — │ Add middleware │ ○ Pending │
│ 5/6 │ — │ Database layer │ ○ Pending │
│ 6/6 │ — │ Tests & docs │ ○ Pending │
└───────┴────────┴───────────────────────┴────────────┘

Elapsed: 32m | Estimated: 90m | Progress: 33%

Tasks broken into 10-15 minute chunks. Progress tracked automatically.

Step 4/4
✓ All 6 chunks completed — archiving to memory

Skill synthesized: go-rest-api.md

┌─ Active Tasks ─────────────────────────────────────────┐
│ a3f8… │ api │ Build REST API in Go │ ✓ Complete
└────────────────────────────────────────────────────────┘

Total time: 94 minutes
Skill available for future API tasks

Completed tasks become reusable skills. Build your personal knowledge base.

The Path to Mastery

Point IKKF at your AI agent, then watch the seven phases execute end-to-end

ikkf-cli v3.6.1
$ ikkf start "Build WebSocket server in Go"
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ 🎯 AGENT ENGAGED — driving all 7 phases ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Phase 1: Acknowledged — IKKF protocol engaged
Phase 2: Domain — detected Go + WebSocket
Phase 3: Research — 2026 best practices loaded
Phase 4: Decomposition — breaking into 6 chunks...
$ ikkf status
┌─ Active Tasks ─────────────────────────────────────────┐
│ a3f8… │ api │ Build WebSocket server │ 2/7 phases │ │
└────────────────────────────────────────────────────────┘

Seven Disciplines

Each belt represents a level of mastery in the IKKF protocol

Own Your Skills

Every skill is generated from your own tasks, for your workflow and setup — plain-text SKILL.md you can read and audit line by line. No opaque, externally-created skills that might be doing something you never approved.

AI Agent Integration

IKKF pairs with your AI agent to run every phase. Point it at OpenAI, Claude, Ollama, Gemma, or any OpenAI-compatible gateway.

Universal Providers

One protocol, every agent. Claude, Hermes, OpenClaw, local models, or your own gateway — swap providers in a minute.

Local-First & Private

Runs on your machine with no cloud dependency and no telemetry. Use local models for full privacy, or cloud agents for speed.

7-Phase Execution

Not just tracking — the full journey runs end-to-end: Acknowledge → Detect → Check → Research → Decompose → Synthesize → Execute.

Two Execution Modes

Light mode for instant scaffolding, or Full mode where the agent does deep research and builds real deliverables.

Real Deliverables

Phase 7 writes actual files — apps, docs, and reusable skills — into your workspace, not just plans on a screen.

Synthesis Gate

Hard-block on task completion. Expertise is distilled into a permanent skill before a task closes. No knowledge debt.

Portable & Configurable

Works vanilla in any setup. Point IKKF at any host, port, or model — nothing is hard-wired.

The Way of Seven Phases

IKKF transforms uncertainty into structured execution

1

Acknowledge

State IKKF activation. Set expectations with the user.

2

Domain Detection

Identify core technology from task description in under a minute.

3

Check Existing

Search for existing skills. Verify currency of knowledge.

4

Research

Web search for 2026 best practices. Load current expertise.

5

Decomposition

Break into 10-15 minute chunks. Estimate time for each.

6

Synthesis

Create SKILL.md with framework, code samples, and pitfalls.

7

Execute & Persist

Complete chunks, update status, archive to long-term memory.

Free. For Everyone. Forever.

No license. No paywall. The full IKKF protocol, yours to keep.

V3 — FREE FOREVER

IKKF Core

$0
No license required

The entire v3 protocol, unlocked forever. No machine-lock, no expiry, no paywall.

  • ✓ Full 7-phase IKKF protocol
  • ✓ Unlimited tasks
  • ✓ Skill library & synthesis
  • ✓ Resume/restore
  • ✓ Local-first — no cloud, no telemetry
  • ✓ All 3.x.x updates free, forever
  • ✓ v3 stays free even if a v4 ships
Get IKKF — Free

Support the Project

Pay What You Want

IKKF v3 is free forever — this isn't a trial or a teaser. If it saves you time, buy me a coffee — or fund the next build.

  • ☕ $5 — Buy a coffee
  • 🍺 $15 — Buy a few rounds
  • 🚀 $50 — Fund the next build
  • 🎯 Your amount — from $1 up
  • ✓ Name on the thank-you page
  • — No capability gating, ever
☕ Support IKKF

Your support keeps IKKF free and open for everyone. Every coffee goes back into the build.

The Future of IKKF — v4

A native desktop app that brings the whole protocol to your fingertips — no terminal, no configuration dance.

Native Apps

A first-class macOS app — built in Swift, not a wrapper — with more platforms on the way.

Self-Configuring Agents

Point it at OpenClaw, Claude, OpenAI, or local Ollama and it just works. No base URLs, no hunting for keys.

A Skills Library You Own

Every skill you synthesize, browsable and auditable in-app — built from your work alone.

Clean, Modern, Local-First

Your data stays on your machine. No cloud, no telemetry.

On pricing: v3 stays free forever, as promised. v4 is being built to be worth paying for — however it ships, the people who support IKKF now help decide the shape of it.

Begin Your Training

One command to install. No dependencies required.

# One-line install — free, no license required
curl -fsSL https://ikkf.info/install.sh | bash

# Or download and verify
curl -fsSL https://ikkf.info/install.sh -o install.sh
bash install.sh

# Initialize and start
ikkf init
ikkf start
# In PowerShell (Admin)
irm https://ikkf.info/install.ps1 | iex

# Or download and run
# Download install.ps1, then right-click → "Run with PowerShell"

# Initialize and start
ikkf init
ikkf start
# Download the CLI package
curl -fsSL https://ikkf.info/ikkf-cli.zip -o ikkf-cli.zip
unzip ikkf-cli.zip -d ikkf-cli
cd ikkf-cli

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # Linux/Mac
# or: venv\Scripts\activate  # Windows

# Install dependencies
pip install -r requirements.txt

# Run
python3 -m ikkf --help
Σ