Personal Knowledge Agent

Turn Claude Code into your personalized knowledge assistant.

This repo provides a ready-to-use structure for storing your professional knowledge, notes, and references—making Claude Code dramatically more useful for your actual work.

Prerequisites

• Claude Code CLI installed
• Obsidian (optional but recommended—this repo works as a vault)

Why This Exists

Most professionals have years of accumulated expertise trapped in:

• Scattered notes and documents
• Bookmarked articles they'll "read later"
• Mental models they can't easily articulate
• Procedures they've refined through trial and error

Claude Code becomes exponentially more valuable when it can access YOUR knowledge—not just generic information from the internet.

Quick Start

1. Clone this repo

git clone https://github.com/drewautomates/personal-knowledge-agent.git
cd personal-knowledge-agent

2. Open with Claude Code

claude

3. Run setup

/setup

This walks you through personalizing your assistant—your role, expertise, and how you like to work.

4. Start adding your knowledge

Drop files into the appropriate folders:

Folder	What goes here
knowledge/inbox/	Quick capture, daily notes, unsorted thoughts
knowledge/notes/	Refined observations, lessons learned, insights
knowledge/references/	Articles, PDFs, documentation, research
knowledge/projects/	Active project documentation and context
knowledge/systems/	SOPs, workflows, automations, processes
knowledge/prompts/	Prompt library, AI templates, agent configs
knowledge/ideas/	Product concepts, experiments, explorations
templates/	Document templates you reuse

Configuration

MCP Integrations (Optional)

The .mcp.json file includes a placeholder for Noverload—a service for saving and searching web content. To use it:

1. Get your API token from Noverload
2. Replace ADD_YOUR_TOKEN_HERE in .mcp.json with your actual token

If you don't use Noverload, you can safely delete the .mcp.json file or leave it as-is.

See docs/advanced-mcp-setup.md for other integrations (web search, browser automation).

Available Commands

Command	What it does
/setup	Personalize your assistant (run this first)
/save-insight	Capture knowledge from your current conversation
/search-knowledge [query]	Search across your entire knowledge base
/daily-brief [topic]	Get a contextual summary for today's work
/draft-email [description]	Draft an email in your writing style

How It Works

CLAUDE.md

The CLAUDE.md file is your personalized context. Claude reads this to understand who you are, your expertise, and how to help you best.

Skills

Files in .claude/skills/ define how Claude should work with you:

• writing-style.md - Your voice, tone, and communication patterns
• domain-expertise.md - Your professional knowledge areas
• decision-frameworks.md - How you approach problems

Commands

Files in .claude/commands/ are workflows you can trigger with /command-name.

Example Use Cases

Packaging Engineer

• Store ISTA testing protocols and accelerated aging calculations
• Save lessons from past test failures
• Quick reference for ASTM standards

Marketing Professional

• Keep campaign frameworks and proven strategies
• Save competitor research and market insights
• Store brand voice guidelines for consistent content

Software Engineer

• Architecture decision records
• Team coding conventions and patterns
• Debugging procedures for common issues

Financial Analyst

• Valuation models and formulas
• Industry benchmarks and ratios
• Report templates and formatting standards

Contributing

This is a template repo—fork it and make it yours. If you build something useful that could help others, PRs are welcome.

Ideas for contributions:

• New commands for common workflows
• Industry-specific skill templates
• Documentation improvements

License

MIT — see LICENSE for details.

---

Built for professionals who want Claude Code to actually know their work.