Agent Knowledge Repo Blueprint — AI skill for Claude Code
A self-contained guide for an AI agent to bootstrap a personal Open Knowledge Format (OKF) knowledge repo: domains, AGENTS.md, generated indexes, secrets pattern.
How to install Agent Knowledge Repo Blueprint
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open perelin/agent-knowledge-repo-blueprint and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Agent Knowledge Repo Blueprint does
A self-contained guide for an AI agent to bootstrap a personal Open Knowledge Format (OKF) knowledge repo: domains, AGENTS.md, generated indexes, secrets pattern.
Alternatives in AI
- Xerj — Local-first search engine and MCP server for AI agents 12.5k ★
- Codeseek — Rust-powered code intelligence CLI for AI coding agents 764 ★
- Obsidian + Claude Code: Rebuild Your Second Brain With AI — Build an AI-powered personal knowledge management system from scratch 540 ★
README
Agent Knowledge Repo — Blueprint
A single, self-contained guide you hand to an AI coding agent (Claude Code, Codex, OpenCode, …) so it can bootstrap a **personal "agents" knowledge repo** for you: a git repo of plain markdown that agents use to operate your servers, self-hosted services, apps, home devices and SaaS APIs.
The structure follows the [Open Knowledge Format (OKF)](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md):
- Operative layer —
AGENTS.md(+CLAUDE.mdsymlink) per repo and per domain: danger zones, access, common operations. Auto-loaded by the agent. - Knowledge layer — one markdown concept per topic, with YAML frontmatter
(
type,resource,status, …). Read on demand. - Navigation layer — generated
index.mdfiles for progressive disclosure.
Plus a secrets pattern (secret store as source of truth, `.env` files restored from it) and two small scripts to validate the bundle and regenerate indexes — embedded in the guide, so there is nothing else to download.
How to use
- Create an empty directory / git repo for your knowledge base.
- Give your agent `BOOTSTRAP-GUIDE.md`, e.g.:
Read BOOTSTRAP-GUIDE.md and set up this repo accordingly. Interview me about my systems, then create the first domain.
- Add one domain per system as you go. Run
docs/okf/validate.shanddocs/okf/generate-index.shafter changes.
The guide itself is an OKF concept (note its frontmatter) — a live example of the format.
Background
Distilled from a knowledge repo that has been in daily agentic use for managing a homelab and a set of self-hosted services. The original stays private because it is personal by design (hosts, accounts, decisions); this blueprint contains only the structure and conventions.
License
MIT — see [LICENSE](LICENSE).
Related Skills
Karpathy LLM Wiki Stack
A comprehensive, build-ready reference for constructing a high-performance personal knowledge system using Obs
LLM Wiki
A pattern for building personal knowledge bases using LLMs. This is an idea file, it is designed to be copy pa
Andrej Karpathy LLM Wiki
A minimal CLAUDE.md template that turns any LLM CLI into a personal knowledge base. Drop in one file, start in
Learnlance
Learn from your AI coding agents. Learnlance turns AI-generated code into a personal knowledge graph of concep
LLM WIKI TO Agent Template
Meta-template: bootstrap one Obsidian vault + one Hermes Telegram librarian + paranoid GitHub backup, followin
Bootstrap Agent Architecture Plugin
Claude Code plugin to bootstrap and govern AI agent architectures (Claude Code, Cursor, Codex) — roles, task l
Related Agents
Ha Blueprint Author
Authors one Home Assistant blueprint (automation, script, or template domain) as a single self-contained YAML
Sheet Designer
Use this agent to render or refresh a Blueprint project's Sheets/engineering-sheets.html — one self-contained
Executive Master Agent
Use this agent when coordinating high-level strategic operations across multiple domains of a Personal AI Empl