name	agents-repository
description	Home directory for agentic AI tools and skills

Agents Repository

A centralized repository for AI agent capabilities, skills, and MCP services.

Structure

~/.agents/
├── .git/                    # Git repository
├── skills/                  # Skills directory
│   ├── README.md           # Skills overview
│   ├── README_zh.md       # 中文说明
│   └── <skill-name>/      # Individual skill folders
│       └── SKILL.md       # Skill definition
├── mcp/                    # MCP server
│   ├── README.md           # MCP server overview
│   └── src/               # Source code
└── .skill-lock.json        # Skill lock file

Quick Start

Skills

Skills are reusable task-specific workflows stored in skills/ directory. Each skill is a self-contained SKILL.md file with YAML frontmatter.

Available Skills:

Skill	Description
discovering-project-context	Fast project discovery and architecture mapping
writing-plans	Create detailed implementation plans
brainstorming	Structured brainstorming sessions
systematic-debugging	Systematic debugging workflows
deep-research	Multi-source research with citations
commit	Conventional commit creation
find-docs	Current library documentation lookup
biomedical-clinical-strategy-consultant	Biomedical and clinical evidence-based consulting
chart-visualization	Chart and map rendering
excalidraw-diagram-generator	Excalidraw diagram generation
esl-coder	Pair programming with English tutoring for non-native speakers
financial-investment-strategy-consultant	Financial and investment strategy consulting
minimax-docx	DOCX document creation, editing, and formatting
minimax-pdf	High-quality PDF creation, filling, and reformatting
minimax-xlsx	Excel and spreadsheet creation, editing, and validation
obsidian-daily-note-todo	Obsidian daily notes integration
codex-daily-summary	Codex work logging
analyzing-codex-token-usage	Token usage reports
philosophy-humanities-cognitive-architect	Philosophy and humanities cognitive consulting
personification	Human-tone writing adapter
pptx-generator	PowerPoint presentation generation and editing
caveman	Ultra-compressed communication, 6 intensity levels
technical-proposal-writing	Technical proposal style guide
ascii-art-diagrams	Text diagram guide with ASCII-safe defaults and optional Unicode layout mode

MCP Server

A NestJS-based MCP server that exposes skills as MCP tools.

Endpoints:

• POST /mcp - HTTP Streamable (for network access)
• STDIO - Local MCP client communication

Tools:

• list_skills - List all available skills
• get_skill - Get skill content by name

Start the server:

cd ~/.agents/mcp
npm install
npm run build
npm run start

Development

Adding a New Skill

1. Create a new directory under skills/:

   mkdir skills/my-new-skill

2. Create SKILL.md with frontmatter:

   ---
   name: my-new-skill
   description: Brief description of what this skill does
   ---
   
   # My New Skill
   
   ## Overview
   ...

3. Commit changes:

   git add skills/my-new-skill
   git commit -m "feat(skills): add my-new-skill"

Syncing Superpowers

Superpowers skills are synced from upstream obra/superpowers:

./scripts/sync-superpowers.sh

License

This repository contains multiple components with potentially different licenses. Check individual LICENSE files in each directory.