Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/keshrath/agent-knowledge/claude-mdgit clone --depth 1 https://github.com/keshrath/agent-knowledgeWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.01822 | $0.01822 |
| Opus 5 | $0.00911 | $0.00911 |
| Sonnet 5 | $0.00364 | $0.00364 |
| Haiku 4.5 | $0.00182 | $0.00182 |
Grade A, and why
agent-knowledge CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 140 lines — stays where its author put it; the contents beside it link to each section on GitHub.
agent-knowledge
Architecture
Layered architecture — single server.ts handles MCP tools, separate dashboard.ts for HTTP/WebSocket:
scripts/
tree-sitter-extract.mjs Standalone CLI for zero-token code structure extraction
tree-sitter-lang.mjs Per-language tree-sitter query definitions (8 languages)
setup.js Automated setup wizard (MCP server + hooks + skill install)
hooks/ Claude Code lifecycle hooks
skills/
knowledge-ingest/
SKILL.md Claude Code skill file
src/
server.ts MCP server, 6 tool definitions, request routing
dashboard.ts HTTP + WebSocket server, REST API, file watcher
index.ts Entry point (MCP stdio + dashboard auto-start)
types.ts KnowledgeConfig, getConfig(), getVersion()
package-meta.ts Cached name/version from package.json
validate.ts ValidationError class, input validation
version.ts Re-exports getVersion from types.ts
knowledge/
store.ts Markdown CRUD, frontmatter parsing, path traversal protection
search.ts TF-IDF search over knowledge entries with regex fallback
git.ts git pull/push/sync with timeouts
distill.ts Session auto-distillation with secrets scrubbing
graph.ts Knowledge graph — edges table, link/unlink/traverse (BFS)
scoring.ts Confidence/decay scoring — entry_scores table, auto-promotion
consolidate.ts Memory consolidation — TF-IDF duplicate detection, cluster grouping
reflect.ts Reflection cycle — surfaces unconnected entries, generates prompts
analyze.ts Graph analysis — god nodes, bridges, gaps, knowledge brief
sessions/
parser.ts Multi-format session parsing with mtime-based cache
indexer.ts Background indexing for sessions
search.ts TF-IDF ranked search with 60s global index cache
scopes.ts Search scopes (errors, plans, configs, tools, files, decisions)
summary.ts Session summaries, topic extraction, file path detection
adapters/
index.ts SessionAdapter interface, adapter registry, auto-init
opencode.ts OpenCode adapter (SQLite database)
search/
tfidf.ts TF-IDF scoring engine (tokenizer, stopwords, index)
fuzzy.ts Levenshtein distance, sliding window fuzzy matching
excerpt.ts Search result excerpt generation
types.ts SearchResult, SearchOptions interfaces
embeddings/
index.ts Embedding provider registry
factory.ts Provider factory (auto-detect available providers)
types.ts EmbeddingProvider interface
claude.ts Claude/Voyage embeddings
openai.ts OpenAI embeddings
gemini.ts Gemini embeddings
local.ts Local embedding fallback
vectorstore/
index.ts Vector store facade
store.ts SQLite-backed vector storage with cosine similarity
chunker.ts Document chunking for embedding
ui/
index.html Dashboard SPA
styles.css MD3 design tokens (light + dark)
app.js Client-side vanilla JS (WebSocket, tabs, rendering)
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago First seen · 140 lines · 1,822 tokens per session scan A f27b18b1472a
agent-knowledge CLAUDE.md is an instructions file published in the GitHub repository keshrath/agent-knowledge (15 stars, last pushed 4mo ago), licensed MIT. It adds 1,822 tokens to every session, about $0.0091 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
markdown-vault-mcp AGENTS.md
Instructions for pvliesdonk/markdown-vault-mcp, covering markdown vault mcp, design, project structure, conventions and skills.
markdown-vault-mcp CLAUDE.md
Instructions for pvliesdonk/markdown-vault-mcp, a project described as: Generic markdown collection MCP server with FTS5 + semantic search, frontmatter-aware indexing, and incremental reindexing.
Axon copilot-instructions.md
Instructions for jyunming/Axon, covering axon knowledge center — copilot instructions, what axon is, project namespaces, hierarchical projects (up to 5 levels) and merged read-only scopes.
Axon developer.instructions.md
Instructions for jyunming/Axon, covering role: developer, core conventions, document schema — never deviate, config.yaml → dataclass mapping and adding a new loader.
Axon hotfix-responder.instructions.md
Instructions for jyunming/Axon, covering role: hotfix responder, hotfix workflow, 1. identify and scope the incident, 2. branch from main (not develop) and 3. implement the fix.
Axon security-auditor.instructions.md
Instructions for jyunming/Axon, covering role: security auditor, known risk areas in this codebase, 1. bm25 serialization — src/axon/retrievers.py, 2. path traversal — src/axon/api.py /ingest endpoint and 3. dependency cves.