Skills & slash commands
The Beakr CLI ships with a Claude Code skill and pre-built slash commands that teach your AI assistant how to use the knowledge base effectively.
Beakr skill
The beakr skill activates automatically when you ask Claude about your organization, team, projects, or decisions. It teaches Claude when and how to use each MCP tool without you needing to specify which tool to call.
The skill uses progressive disclosure -- Claude loads the core decision tree first, then reads detailed reference docs only when it needs them:
| Reference | Loaded when |
|---|---|
| Core skill (SKILL.md) | Always -- tool selection, scoping, citation rules |
| Research workflow | User asks a broad research question |
| Writing pages | User wants to create or update a KB page |
| Auditing | User wants to check KB quality |
| Provenance | User asks where information came from |
What the skill knows
- Which tool to use for each type of question (research vs search vs browse)
- How to scope queries to projects, spaces, or personal knowledge
- How to cite sources and present provenance stances
- Page type conventions (topic, person, decision, meeting, etc.)
- Content formatting rules (section markers, cross-references, Related Pages)
- How to interpret provenance stances (supports, contradicts, qualifies)
Slash commands
In addition to the automatic skill, four slash commands are available for specific workflows. Type / in Claude Code to see them.
/kb-research
Deep research across your entire knowledge base. Searches multiple spaces in parallel, reads top pages, traces provenance, follows the knowledge graph, and synthesizes findings by theme with citations.
/kb-research What decisions were made about the API redesign?/kb-search
Fast, targeted search. Searches all spaces in parallel, reads the top hits, follows links, and presents synthesized answers with page citations -- not just raw search results.
/kb-search authentication flow/kb-write
Create or update a knowledge base page. Checks for duplicates, finds the right parent, chooses the correct page type, writes with proper section markers and cross-references, and verifies the result.
/kb-write A page about our authentication architecture/kb-audit
Audit knowledge base quality. Checks the graph for orphans and dead ends, spots structural issues, samples content quality, verifies provenance, and reports findings by severity with fix recommendations.
/kb-audit
/kb-audit focus on the engineering spaceInstallation
The skill and slash commands are included in the beakr-cli package. Once you have the MCP server configured (see MCP setup), the skill is automatically available. The slash commands live in .claude/commands/ in the beakr-cli repo.
To use the slash commands in your own project, copy them:
# From the beakr-cli repo
cp -r .claude/commands/ /path/to/your/project/.claude/commands/You can create your own slash commands by adding markdown files to .claude/commands/ in your project. Each file becomes a /filename command. Use $ARGUMENTS as a placeholder for user input.