skill
third-brain-v7-skills
agent wiki +engineering skills
Set up
Skills are installed by placing their folder where your agent loads skills.
Install instructions come from the README
README
synced Oct 14, 2026Third Brain V8.1 Skills
Verification-first Agent Skills for Codex OS, with optional compatibility adapters for Claude Code, Gemini, Cursor, and Windsurf. Build a persistent knowledge operating system with Obsidian provenance, scheduled loops, bounded static dependency graphs, context management, and multi-agent orchestration.
Install 21 reusable agent skills for ingesting sources, auditing workflows, compiling interlinked wikis, running daily knowledge loops, verifying claims before shipping, managing token costs, engineering bounded loops and static dependency graphs, and orchestrating multi-agent teams.
Use this if:
- Your AI agent keeps forgetting context between sessions
- You want to enforce verification gates before "done" claims
- You need to structure knowledge as linked pages (like Obsidian) instead of scattered chat history
- You're building agent workflows that should learn and compound over time
- You want Obsidian wiki knowledge to update skills, SOPs, schemas, and automation through supervised promotion gates
Quick Start
1. Clone & Install
git clone https://github.com/Mark393295827/third-brain-v5-skills.git
cd third-brain-v5-skills
bash install.sh codex # Codex is the primary host/kernel
Windows PowerShell uses .\install.ps1 codex. Compatibility adapters require an explicit non-Codex target.
2. Try a Skill
Paste this into Codex:
Use wiki-ingest on this source. Stage an immutable source, author a governed concept candidate, plan navigation updates, and return a verification summary. Treat entity authoring as a separate reviewed capability.
Then paste a URL, article, PDF text, or any source you want to capture.
3. Next Steps
See the 3-Minute Quickstart for a complete walkthrough.
Full guide: GUIDE.md
Command centre and distribution: V8.1 Codex Agentic OS command centre. Start it with python tools/agentic_os_server.py --state-root .agentic-os-state; the host is localhost-only by default and requires T02 runtime receipts. Claude/Gemini/Cursor/Windsurf remain compatibility adapters, not the primary runtime.
中文历史进阶手册:V7 最大潜力使用手册(参考)
🔥 V8.1 多智能体 Worker 流水线手册 & Worker Flows 规范:事务式流水线(Stage → Author → Graph Plan → Govern → Commit/Postcheck → optional Deliverable),归档只发生在验证提交之后。
The Problem
| Scenario | Before | After |
|---|---|---|
| Research PDF | Summarized once, then forgotten | wiki-ingest: source notes, concept pages, linked wiki |
| Coding session | Agent: "I fixed it" (no proof) | verify-before-claim: requires test output + exit code before any claim |
| Daily work | Tasks and ideas scatter across chat | daily-okr: one insight, one wiki update, one action, one output, daily score |
V8.1 Operating Model
V8.1 keeps the wiki as durable disk and governance, gives every skill a profile-aware execution contract, and makes python -m tools.worker_flow.cli the only canonical transactional runtime:
Input -> Source -> Wiki compile -> Daily loop -> Agent/Wiki flywheel -> Skill/SOP upgrade -> Verification
The upgrade adds seven hard defaults:
- Profiles match risk: one-shot, stateful, loop, and high-risk work load only the controls they need.
- Source provenance stays immutable: raw source notes and block refs remain the audit layer.
- Loops have contracts: Trigger -> Execute -> Verify -> State, with budgets and recovery.
- Context is zero-overhead by default: hot paths load only what the task needs.
- Automation is bounded: scans and queues can run unattended; semantic writes stay supervised.
- Teams need ownership: multi-agent work requires write scopes, IPC, join gates, cleanup, and evidence.
- Rules promote through evidence: wiki insights become schema or skill rules only after repeated support and a cheap check.
See the V8.1 Worker Flow, the Agent Skills standard, and the historical V7 release notes.
V8.1 keeps graph-engineering bounded to static DAGs; dynamic expansion and cyclic graphs remain out of scope.
Core Skills (Start Here)
🧠 Knowledge & Verification
| Skill | What it does |
|---|---|
| wiki-ingest | Preserve an immutable source, compile linked understanding, enforce promotion boundaries, and verify every touched file. |
| verify-before-claim | Iron rule: no completion claim without fresh, scope-matched evidence; consequential actions also require independent verification, approval, and rollback. |
📅 Daily Loop
| Skill | What it does |
|---|---|
| daily-okr | Execute a 7-KR cycle: Input → Cognition → Wiki → Behavior → Creativity → Output → Feedback, with an artifact or receipt for every completed KR. |
🎯 Behavior & Creativity
| Skill | What it does |
|---|---|
| behavior-design | Turn outcomes into observable minimum behavior, cues, SOPs, recovery, evidence, and review. |
| creativity-engine | Generate mechanism-diverse options, rank evidence gaps, and define three bounded minimum experiments. |
🔬 Research & Quality
| Skill | What it does |
|---|---|
| deep-research | STOW-compatible research harness with evidence trails, source/claim ledgers, privacy checks, and direct handoff to wiki-ingest. |
| session-learn | Extract knowledge patterns from sessions — concepts, entities, corrections, patterns, ideas, decisions, gaps. Closure protocol ensures learning feeds back into the wiki. |
📊 Context & Engineering
| Skill | What it does |
|---|---|
| context-manager | Derive budgets at runtime, checkpoint state, compact with KEEP/SUMMARIZE/DROP/RETRIEVE, and route by capability. |
| loop-engineering | Control temporal depth: turn repeatable work into a bounded Trigger -> Execute -> Verify -> State loop with durable state, finite budgets, and explicit stop/recovery rules. |
| graph-engineering | Control dependency width: validate bounded static DAGs with explicit dependencies, independent branches, typed joins, and node-local recovery. |
| agentic-engineering | Design agent workflows as spec-driven macro actions with quality ceilings, verification gates, delegated-action boundaries, and state checkpoints. |
| harness-engineering | Provide the runtime scheduler, permissions, leases, tools, provenance, and observability needed to execute agent workflows safely. |
| agent-teams-command | Admit and command multi-agent processes with exclusive ownership, typed IPC, isolated writes, serial integration, evidence, and cleanup. |
Complete Skill List
📥 Ingestion & Knowledge
wiki-ingest— Stage immutable sources, author governed concept candidates, plan graph updates, and hand off optional entity authoring for separate reviewknowledge-ops— Multi-layer knowledge management: classify, deduplicate, preserve evidence hierarchy, vector + Markdown retrievalwiki-lint— Health check: P0/P1 graph health, frontmatter, source refs, wikilink density, provenance debt
🔄 Daily Workflow
daily-okr— 7-KR evidence cycle with minimum-day degradation and durable closeoutcognitive-compile— 8-section framework: Question → Facts → Concepts → Pattern Recognition → Conflict Detection → Hypothesis Generation
🎨 Behavior & Creativity
behavior-design— Outcome → minimum behavior → cue → SOP → evidence → reviewcreativity-engine— Mechanism-diverse combinations, scoring, and falsifiable minimum tests
🔬 Research & Quality
deep-research— STOW-compatible research harness, evidence trails, source/claim ledgersverify-before-claim— Fresh scope-matched evidence, independent checks, approval, rollback
🔄 Learning & Flow
session-learn— 7 signal types: concepts, entities, corrections, patterns, ideas, decisions, gapsproject-flow-ops— Execution flow: triage, plan, track, review across projects
📊 Context
context-manager— Runtime budgets, checkpoint replay, compaction, retrieval, capability routing
Utility command: commands/token-cost-tracker.md estimates, logs, and reports token usage; it is not one of the 21 Agent Skills.
🏗️ Engineering
loop-engineering— Temporal depth through bounded loop contracts, independent verification, finite budgets, and stop/recovery rulesgraph-engineering— Dependency width through bounded static DAGs, explicit branches, typed joins, and node-local recoveryagentic-engineering— Spec-driven macro actions, quality ceilings, verification gates, state checksharness-engineering— Runtime scheduler, permissions, system-call tools, delegated gates, provenance, observabilityagent-teams-command— Multi-agent process ownership, IPC, integration, async budgets, and evidence gates
💼 Strategy & Operations
startup-evaluation— Startup health: entrepreneurship, VC 5T, PMF, runway, team, unit economicsanthropic-os— Governed operating-system experiments: Four-C, 3B, prediction errors, permission ladderai-six-sigma-property-os— AI + Ontology + DMAIC for property work orders, dispatch, quotes, evidence
How These Skills Fit Together
LLM (CPU) + Context (RAM) + Wiki (Disk)
External Sources ──→ wiki-ingest + knowledge-ops ──→ Knowledge Layers
↓
Daily Loop (daily-okr)
/ / \ \ \
Input Cognition Wiki Behavior Creativity
|
Output → Feedback
↓
session-learn (extract patterns)
↓
verify-before-claim (quality gate)
↓
Loop depth / Graph dependency width
↓
Multi-agent teams (agent-teams-command)
The system is a closed loop: ingest sources → process daily → extract learning → verify claims → promote rules → scale to teams.
Architecture & Design
Third Brain V8.1 treats agents as LLM OS processes:
- LLM = CPU
- Context = RAM
- Wiki/Obsidian = Disk
- Tools = System calls
- Skills = Executable programs
- Harness = Kernel
- Agent teams = Processes
Design Layers
| Layer | Principle | Skills |
|---|---|---|
| 🧠 Knowledge OS | Capture, structure, lint, and promote knowledge over time | wiki-ingest, knowledge-ops, wiki-lint |
| ⚡ Daily Loop | Close the knowledge-to-action cycle every day | daily-okr, cognitive-compile |
| 🎯 Behavior & Creativity | Turn knowledge into habits and novel ideas | behavior-design, creativity-engine |
| 🔬 Research & Quality | Verify before claiming, research with rigor | deep-research, verify-before-claim |
| 🔄 Continuous Learning | Extract patterns from every session | session-learn, project-flow-ops |
| 📊 Context | Manage hot context, durable checkpoints, and runtime budgets | context-manager |
| 🏗️ Engineering | Design bounded loops, static dependency graphs, harnesses, agent workflows, and multi-agent systems | loop-engineering, graph-engineering, agentic-engineering, harness-engineering, agent-teams-command |
| 💼 Strategy & Operations | Evaluate startups, design AI quality systems | startup-evaluation, anthropic-os, ai-six-sigma-property-os |
Engineering boundaries are deliberate: Loop Engineering controls temporal depth; Graph Engineering controls dependency width; Agent Teams Command controls process ownership, IPC, and integration; Harness Engineering supplies the runtime scheduler, permissions, and observability. A graph node may contain a Loop or Agent Team, but V8.1 does not support dynamic or cyclic graphs.
Skill Adoption Path
Start small. Add skills as you need them.
| Stage | Core Skills | Unlock When |
|---|---|---|
| Week 1 | wiki-ingest + verify-before-claim | You can ingest 1 source/day + every claim has fresh evidence |
| Weeks 2-4 | + daily-okr + session-learn | Daily artifacts and verified learnings feed back to the wiki |
| Month 2+ | + cognitive-compile + behavior-design + creativity-engine | Wiki has 50+ pages or repeated decisions need synthesis |
| Month 3+ | + knowledge-ops + loop-engineering + harness-engineering + agentic-engineering | Retrieval, looping reliability, permissions, or delegated actions become bottlenecks |
| Dependency graph | + graph-engineering after loop-engineering | Explicit dependencies, independent branches, typed joins, or node-local recovery create more value than orchestration and review cost |
| Multi-agent | + agent-teams-command + project-flow-ops | Work splits into separate owners with clear integration gates |
| Strategy | + startup-evaluation + anthropic-os + deep-research | Need startup health, market, operating-system decisions |
| Operations | + ai-six-sigma-property-os | Need measurable service quality, dispatch, evidence loops |
Installation
For Codex CLI (Primary host/kernel)
# Personal skills (available across all projects)
bash install.sh codex
For Cursor
bash install.sh cursor
For Windsurf
bash install.sh windsurf
Compatibility adapters: Claude Code / Gemini CLI
bash install.sh claude
bash install.sh gemini
Full guide: GUIDE.md
Example Workflows
Each workflow is copyable into your agent. See examples/ for complete, verified examples:
- 3-minute quickstart — Fastest path to useful output
- Research PDF to wiki — Turn a source into linked pages
- Verified code session — Use verification gates before claiming a fix
- Daily knowledge loop — Run a compact daily OKR workflow
- Startup evaluation sprint — Turn an idea into validated assumptions
Wiki Structure
Skills default to STOW paths (configurable via system/config.md):
sources/ ← Immutable source notes (articles, PDFs, transcripts)
wiki/
├── concepts/ ← 13 contracted domains
├── entities/ ← people, companies, funds-investors, products, orgs
└── outputs/ ← gmail-digests, evaluations, compilations
maps/
├── domain-mocs/
├── system-indexes/
├── project-maps/
└── canvases/
system/ ← Deployed contracts, config, schema, templates, runs
Tools & References
| Resource | Purpose |
|---|---|
| tools/index.html | V8.1 visual skill navigator |
| tools/token-calculator.html | Historical V5 cost-model calculator; not a runtime authority |
| GUIDE.md | Full installation & troubleshooting |
| V7 最大潜力使用手册(历史参考) | Earlier profile、知识飞轮、Agent 工程、治理和 30 天采用路径 |
| CLAUDE.md | Claude Code setup |
| CONTRIBUTING.md | How to contribute skills |
What This Is NOT
- Not a chat wrapper. Skills are executable prompts that agents follow; they're not productivity theater.
- Not a productivity tool with 100 metrics. Daily OKR has seven causally linked KRs with evidence.
- Not an all-in-one framework. Pick skills incrementally. You don't need all 20 to start.
- Not prescriptive. Adapt paths, frontmatter, and skill triggers to your workflow.
Philosophy
Three core principles:
- Verification first: No "done" without proof. No claims without evidence. Expected value over confidence.
- Knowledge compounds: Every session should improve the wiki, not scatter across chat history.
- Closed loops: Ingest → Process → Learn → Scale → Verify. No loose ends.
Related Work
- Agent Skills Format — Open specification for agent skills
- llm-wiki-agent — Original STOW pattern implementation by SamurAIGPT
- Karpathy LLM OS — Conceptual framework
Contributing
Bug reports, skill improvements, and PRs are welcome. See CONTRIBUTING.md and CHANGELOG.md.
License
MIT — see LICENSE.
Transparency Note
This project includes growth and outreach tools (in tools/ and outreach/) designed to help the repository reach users via GitHub search and Awesome lists. These tools are optional, dry-run-by-default, and separate from the core skills. If you're installing skills for your own workflow, you don't need them.
The skill frameworks and philosophy are genuine. Use what works for you; ignore what doesn't.