Prometheus Skill Pack guide
Use this guide with the product README for installation and first workflows. Individual pages describe their source contracts and evidence boundaries; a documented feature does not imply every host or harness is certified. The pack supports standalone work, with optional services and a separately installed Companion extension for connected controls.
How this documentation is organized
The guide is built in layers. Read it top to bottom the first time; use it as a reference after that.
Foundations — the why and the what
| # | Page | What it covers |
|---|---|---|
| 01 | Introduction | What the skill pack is, who it is for, the autonomy ladder, and the loop posture |
| 02 | Metaprompting, PMPO, and KBD | The methodology: metaprompting, Prometheus Meta-Prompting Orchestration, Knowledge-Based Development, and the theory behind them |
| 03 | Loop Architecture | The L0–L3 loop levels, nested loops, loop.json, the loop-tick.sh exit-code contract, feedback sources, escalation, and autonomy gates |
| 04 | The Pipeline | PMPO → OpenSpec → forge-rs, with C4 container diagrams |
The substrate — what makes loops compound
| # | Page | What it covers |
|---|---|---|
| 05 | The MCP Server Substrate | MCP component roles, configured endpoints and research providers |
| 06 | Memory and Karpathy-Pattern Learning | The three-layer memory architecture, the self-learning engine, and the cross-session write-back sequence |
| 07 | Sycophancy Correction | The eight patterns (S-01–S-08), modes, strictness, MCP tools, the reflection gate, and the reflection boundary |
The catalog — every skill
| # | Page | What it covers |
|---|---|---|
| 08 | Skills Overview | The skills model, discovery, the AgentSkills.io standard, and the full category index |
| 09 | Process & Orchestration Skills | iterative-evolver, the KBD orchestrator and its child skills, pmpo-elicit, pmpo-outer-loop, pmpo-skill-creator, native-agent, liter-llm-bridge, ideation-mindmap, kbd-evolve |
| 10 | Learn Domain Skills | The 12 learn skills (ui-surface, learn-goal, learn-survey, learn-plan, feynman-loop, learn-grade, learn-retain, learn-practice, learn-certify, learn-kb, learn-about-system, learn-harness), FSRS-6 spaced retrieval, KB adapters, and meta-learning for the Prometheus stack |
| 10 | Language & Domain Skills | Rust, React, Flutter, Tauri, HTMX, TypeScript, Go, Python, architecture, testing, DevOps, document extraction, and the Flint SDK skills |
| 11 | The Artifact Refiner | The artifact-centric refinement engine and all fifteen of its commands |
| 12 | The Native Agent Generator | Generating complete Rust agents, the A2A/AG-UI/A2UI protocols, and agent networks |
The engine room — tools, toolchain, lifecycle
| # | Page | What it covers |
|---|---|---|
| 13 | Tools Reference | forge-rs, prometheus-cli, prometheus-knowledge, liter-llm, surreal-memory-server, prometheus-rust-auditor, and prometheus-exec |
| 14 | The Rust Toolchain & Dynamic Generation | Why Rust, how the binaries are built, and how the pack generates new skills, CLIs, and MCP servers |
| 15 | Hooks & Lifecycle | Lifecycle observations, scoped learning, progress signals and protected-test integrity |
| 16 | CLI & Scripts Reference | Every installer, validator, and runtime script, plus the npm script surface |
| 16a | Spec Engines | OpenSpec (default), Spec Kit, native-kbd: detection, pinning, the five-op adapter contract, and how to add or update an engine |
Deployment — install, run, update, contribute
| # | Page | What it covers |
|---|---|---|
| 17 | Platform Support | Per-tool support: Claude Code, OpenCode, Codex, Kimi Code, MiniMax, Cursor, Windsurf, Gemini CLI, Roo Code, Zed and Cline |
| 18 | Plugins & Marketplace | Claude Code plugins and marketplace, OpenCode plugins, and the distribution model |
| 19 | Installation | Toolchain install (Rust, Go, Node, Docker), the one-command install, and MCP services |
| 20 | Updating | Keeping skills, tools, submodules, and MCP services current with recovery and evidence boundaries |
| 21 | Contributing | The open-source workflow, validation gates, submodules, and importing skills |
Closing
| # | Page | What it covers |
|---|---|---|
| 22 | Advantages & Impact | What changes about your development process, and why |
| 23 | Glossary & Sources | Every term defined, every external claim cited |
UI and team workflows
| # | Page | What it covers |
|---|---|---|
| 24 | Agent teams | Create and adopt teams; role ownership and task lifecycle; messages, handoffs and cross-project requests; models, reasoning and scoped memory |
| 25 | UI/UX routing | Context authority, selective skills, portable installation and completed-phase evidence |
| 26 | Services, ownership and recovery | Repositories, optional Companion, memory/model services, installation and recovery |
Operational
| Document | What it covers |
|---|---|
| Production Readiness Report | Evidence table separating artifact, disposable-runtime, installed-service, and external-deployment certification |
| Deployment Modes | Mode 0-3 capability matrix — which services are required for which features |
| Dynamic Operations with Prometheus Exec | Choosing generated programs versus native agents, Tier P/W/R theory, APIs, receipts, examples, security, and platform evidence |
Design documents, old release receipts and future-work plans are retained as history. They are not current installation instructions. Documentation changes follow the same implementation-first, final local integration boundary as code.