v0.3.0, all gates pass 0 external references 31 original skills

Skills for AI coding assistants

The only MIT-licensed, graph-native skill runtime with zero external dependencies and every skill quality-gated on every commit.

curl -fsSL https://raw.githubusercontent.com/youcisla/Agent-Foundry/main/install.sh | bash
check Copied Browse catalog → Why Agent Foundry
layers
--
Skills
agents
--
Agents
eye
--
Graph nodes
shield
--
Skills gated
box
3
Tested adapters
Adapters

Watch it render

A 9-second tour of Agent Foundry, produced by HyperFrames (Apache-2.0, 36k★) from HTML to MP4 with FFmpeg + Puppeteer. hyperframes render . --quality draft

1920×1080 · 30 fps · 9.0s · H.264 · 1.6 MB · rendered in 53.3s

One command, one daemon

Agent Foundry runs entirely locally. Install, run, verify, no cloud, no SaaS, no telemetry.

install.sh, zsh
$ curl -fsSL https://raw.githubusercontent.com/youcisla/Agent-Foundry/main/install.sh | bash
▸ Installing agent-foundry for claude-code...
✔ Installed: ~/.claude/skills/agent-foundry
✔ 30 skills · 3 agents · 9 endpoints
$ agent-foundry doctor
✔ Config: ~/.config/agent-foundry/config.toml
✔ Index: 30 skills loaded
✔ Daemon: running on 127.0.0.1:8765
✔ API key: ANTHROPIC_API_KEY configured
$ agent-foundry plan "refactor auth middleware"
1. bottleneck-gating (score 0.82)
2. verify-first (score 0.70)
$ agent-foundry run "refactor auth middleware"
→ Using bottleneck-gating...

gears 30 curated skills

Each ≤150 lines with trigger phrases, anti-patterns, and verification checklists. Disciplines, not domain knowledge.

brain 3 agents

af-planner decomposes requests. af-critic scores output. af-orchestrator dispatches subtasks to agents and skills.

graph Graph-aware planning

396 nodes, 626 edges, 44 communities. The knowledge graph feeds back into the planner, boosting related skills 15% higher in the ranking.

refresh Self-improvement loop

Rate outputs, run agent-foundry learn, and the system suggests new trigger patterns. Instincts are user-approvable and MIT.

What you get

Agent Foundry upgrades your workflow without forcing a tool reset.

Without Agent Foundry
cross Your agent doesn't know discipline rules
cross Manual prompt engineering
cross No budget guard
cross No execution log to learn from
cross No quality verification after each run
cross Ad-hoc skill selection
With Agent Foundry
check 30 curated, tested, MIT-licensed skills
check Skill indexer + ranker picks the right skill
check Budget guard with configurable token cap
check SQLite log with judge scores
check af-critic judges correctness, slop, scope
check Live knowledge graph + dependency chips

From the community

Real feedback from early users.

starFilledstarFilledstarFilledstarFilledstarFilled
"The quality gates are what sold me. I know every skill in the catalog is original and verified. No guesswork."
D
Dennis
GitHub Discussion
starFilledstarFilledstarFilledstarFilledstarFilled
"I've been using it for a week. The self-improvement loop actually works, it suggested a trigger pattern I hadn't thought of."
M
Mira
Early tester
starFilledstarFilledstarFilledstarFilledstar
"Clean, focused, no fluff. The graph page alone is worth the install, seeing how the codebase connects is surprisingly useful."
J
Jake
OSS contributor

Everything in one tool

Skills, agents, orchestrator, graph, self-improvement, built to work together.

brain

Skills

Disciplines the model applies to its own work, how to think, not what to know. Each ≤150 lines with trigger phrase, anti-patterns, and verification. 24 core + 6 optional.

agents

Agents

Roles the orchestrator dispatches. af-planner, af-critic, and the new af-orchestrator which decomposes → dispatches → merges subtasks across skills and agents.

gears

Orchestrator

Local daemon: ranks, dispatches, executes, logs, judges. FastAPI, SQLite, lazy-started. HTTP endpoints for everything: /plan, /execute, /loop, /health.

bolt

Engram routing

Adopted from DeepSeek's Engram paper. O(1) N-gram hash → SQLite lookup for hot prompts. Plan + execute the same task in microseconds when the pattern is recognized.

refresh

Self-improvement

Rate executions, run agent-foundry learn, and the system suggests new trigger patterns from successful runs. Instincts stored in SQLite, user-approvable, MIT.

eye

Knowledge graph

396 nodes, 626 edges, 44 communities. Tree-sitter AST extraction, community detection, god nodes, surprising connections. Graph-aware planning boosts related skills 15%.

shield

Quality gates

Three gates on every commit: 34/34 eval, 31/31 validate, 0 external references. Every skill is original, verified, and MIT-licensed.

box

6 harness adapters

Install targets for Claude Code, Hermes, Codex, Cursor, OpenCode, Gemini. 3 tested end-to-end on this machine. Smoke tests verify every install path.

How it works

From prompt to result in one orchestrator pass.

By the numbers

Live from the repo, regenerated on every build, no hand-maintained counts.

skills
30
Skills
agents
3
Agents
terminal
14
CLI commands
route
9
HTTP endpoints
graph
396
Graph nodes
link
626
Graph edges
layers
44
Communities
shield
0
External refs

Harness adapters

An honest tested / documented / untested matrix. We never claim what we haven't verified.

Featured skills

A taste of the catalog. See all 30 →

FAQ

Quick answers to common questions.

How is Agent Foundry different from other agent harnesses?

Agent Foundry ships 30 original skills with a hard zero-external-references gate, every skill is original MIT-licensed work. We also ship a live knowledge graph of the codebase and a 3-gate audit pipeline on every commit, including an external-reference scanner that fails the build if any third-party name leaks in.

What does "graph-native" mean?

Every commit runs a tree-sitter AST extraction of the entire codebase. The resulting graph (396 nodes, 626 edges, 44 communities) feeds back into the orchestrator, related skills get a 15% boost in planning. The graph is a first-class feature, not a visualization afterthought.

Is it free?

Yes. MIT-licensed, all local, no cloud. You supply the API key for your LLM provider. No SaaS, no telemetry, no subscription.

Which harnesses work?

Claude Code, Hermes, and Codex are tested end-to-end. Cursor, OpenCode, and Gemini CLI are documented. Each has a --harness=NAME install path.

Can I contribute a skill?

Absolutely. Fork the repo, add a skill under skills/core/ following the template in community/README.md, and open a PR. Every skill must pass foundry-eval.py and the nox.sh external-reference gate.

Do I need a running daemon?

The daemon is lazy-started on first command. No systemd, no launchd, no Docker. Everything runs locally in ~/.config/agent-foundry/executions.db.

Ship with confidence

30 curated skills, 3 agents, a live knowledge graph, a self-improvement loop, and three quality gates, all MIT, all local.

← Back
↻ Reload
📋 Copy page info
Open on GitHub