Agents

LLM-powered coding and shell assistants that use tools to help with development tasks.

Context Files

Agents use standardized context file paths for providing additional context and rules:

See specification of AGENTS.md files.

• ~/.config/AGENTS.md - Global (user) agent context file
• AGENTS.md - Local (project) agent configuration. It admits nesting files for subdirectories.

MCP Servers

Several Model Context Protocol (MCP) servers are configured to enhance coding assistants capabilities:

Name	Type	Protocol	API Key	Description
Context7	remote	http	CONTEXT7_API_KEY	Up-to-date, version-specific documentation and code examples directly from source repositories

Skills

Standard skills path is adopted as convention

• ~/.agents/skills/ - Global
• .agents/skills/ - Per project

Symlinks to Claude equivalents are also created automatically by the skills manager upon installation:

• ~/.claude/skills/ - Global
• .claude/skills/ - Per project

All assistants I use are compatible with either or both.

Authored Skills

Skill	Description
numbat	Numbat programming language reference for statically typed scientific computations with first-class support for physical dimensions and units.
scientific-calculator	High-precision scientific calculator with full support for physical units, dimensional analysis, unit safety, and built-in physical constants. Wraps the numbat skill for language reference. Requires numbat CLI.

Skills Managers

These are the skills managers I use, in order of precedence.

Playbooks

Playbooks CLI uses the Playbooks skills registry by default, but can fetch and manage skills from a variety of sources, and locks specific versions to .skills-lock.json, both per-project and globally.

npx playbooks find skill

Skills have to be updated manually since there is not a fully non-interactive command for it:

playbooks update skill

Skills by Vercel

skills lets you manage skills across many agentic assistants. It is my default skills manager.

Context7

Similarly, use ctx7 (Context7 Skills) to manage agents skills:

• ctx7 skills install
• ctx7 skills search
• ctx7 skills generate: Generate skills with the help of AI (requires ctx7 login)

Amp

Amp is an LLM coding agent with built-in support for context files.

Configuration

• Settings: ~/.config/amp/settings.json
• Context Support: Built-in support for AGENTS.md files and @ file prefix syntax to read other files

Context File Usage

Amp reads context through:

1. Local AGENTS.md file in project root
2. Global ~/.config/AGENTS.md file
3. Subdir AGENTS.md files in path of files referenced in thread.
4. Referenced files using @ syntax.

Reference: Amp Manual - AGENTS.md

Amp

Amp is an LLM coding agent with built-in support for context files.

Configuration

• Settings: ~/.config/amp/settings.json
• Context Support: Built-in support for AGENTS.md files and @ file prefix syntax to read other files

Context File Usage

Amp reads context through:

1. Local AGENTS.md file in project root
2. Global ~/.config/AGENTS.md file
3. Subdir AGENTS.md files in path of files referenced in thread.
4. Referenced files using @ syntax.

Reference: Amp Manual - AGENTS.md

Free Mode

Amp offers a free tier that can be activated with /mode free.

Claude Code

Claude Code is Anthropic's official CLI coding agent.

Plugins

• Superpowers: Complete software development workflow
• Caveman

Configuration

• User Settings: ~/.claude/settings.json - defines MCP servers and user preferences
• User Context: ~/.claude/CLAUDE.md - global (user) context file
• Project Settings: .claude/settings.json - project-specific configuration
• Project Context: .claude/CLAUDE.md - local (project) context file

Context File Usage

Claude Code reads context through:

1. Global ~/.claude/CLAUDE.md file
2. Local .claude/CLAUDE.md file in project root
3. Referenced files using @ syntax

Note: While Claude Code uses CLAUDE.md as its native context file format, it can reference the standardized AGENTS.md files by including @~/.config/AGENTS.md or @AGENTS.md in the respective CLAUDE.md files.

Reference: Claude Code Settings

MCP Server Configuration

MCP servers are configured through the mcp key in settings.json or via the claude mcp add command. The following MCP servers are pre-configured:

• Context7: Remote HTTP server for up-to-date documentation
• Mise: Local stdio server exposing mise environment information