Claude Agent Toolkit

Advanced skills for Claude Code that enable multi-agent coordination, external service integrations, and intelligent workflow orchestration.

Built with Claude using obra's superpowers framework.

Overview

This repository contains skills that extend Claude Code's capabilities through:

Multi-agent orchestration - Coordinate multiple AI agents in parallel or sequential workflows
External integrations - Connect to Google Workspace, Perplexity AI, Obsidian, and more
Task coordination - Advanced task management and synchronization patterns

Supporting Repositories:

dbmcco/obsidian-mcp - Obsidian MCP server (18 tools)
dbmcco/apple-reminders-mcp - Apple Reminders MCP server (6 tools)
dbmcco/claude-tmux-orchestration - Multi-agent tmux coordination

Prerequisites

Required

macOS - Required for Apple Reminders integration and tmux orchestration
Node.js v18 or higher - For MCP servers and build tools
tmux - For multi-agent orchestration (brew install tmux)
Claude Code CLI - Install from Claude
Git - For repository cloning and version control

Optional

Google Cloud Platform account - For Google Workspace automation
Perplexity AI account - For research integration
Obsidian vault - For knowledge management integration
Linear API key - For Linear issue tracking integration
GitHub token - For GitHub repository management

Skills

`orchestrating-tmux-claudes`

Multi-AI coordination in tmux panes (repo)

Sequential workflows (TDD → code → review → deploy → test)
Parallel dispatch (independent tasks)
Multi-model support (Claude Code, codex, ollama, haiku)
Auto-recovery for stuck agents
Smart integration (auto-commit, feature gates)

`gemini-cli-extension-porting`

Gemini CLI extension workflows for beads and Superpowers

Map skills to Gemini CLI command namespaces
GEMINI.md context and artifact guidance
Prompt workflows paired with hard guardrails (pre-commit/CI)
MCP and tool wiring patterns for extensions

`google-docs-automation`

Google Workspace automation (Docs, Sheets, Slides)

Service account authentication patterns
gspread for Sheets, googleapiclient for Docs/Slides
Common patterns: read/write, formatting, charts
Integration with financial modeling and reporting workflows

`keynote-slides`

Build Keynote-style single-file HTML slide decks

Brand-ready templates with multi-brand theming
Gemini-powered infographic generation (nano-banana model)
Narrative Engine with 17 storytelling frameworks
5-agent review panel for deck quality assurance
Review mode with feedback system for collaborative iteration
Single portable HTML file per deck

`white-paper`

Create print-ready white papers in single HTML files

Professional 8.5x11 layout optimized for print
Strong brand adherence with entity-level theming
Research integration and visual review workflow
Gemini media generation for diagrams and charts
PDF export with proper page breaks
Collaborative document building with co-author workflow

`perplexity-research`

Perplexity API for web research

Structured query design for Claude-interpretable output
Market research, competitive intelligence, technical documentation
Citation tracking and verification
Integration with Claude analysis workflows

`obsidian-vault-intelligence`

Effective Obsidian MCP usage patterns (repo)

Progressive search strategies (query_vault, intelligent_search, search_notes)
Note operations (create, update sections, append)
Cross-reference intelligence (backlinks, contextual companions)
Integration with task management and research workflows
18 available tools for comprehensive vault operations

`reminders-management`

Apple Reminders MCP integration (repo)

List organization and priority management
Time-based task tracking with due dates
Bi-directional sync with Obsidian task system
Integration with coordination workflows
6 available tools for reminder management

`linear`

Linear issue tracking integration

Create and manage Linear issues via bash scripts
GraphQL API wrapper with simple CLI interface
Project and workflow state management
Issue search and filtering
5 bash scripts for Linear workflow automation

`github`

GitHub repository and issue management

Create and manage GitHub issues and pull requests
REST API wrapper with simple CLI interface
Code search across repositories
Label and assignee management
5 bash scripts for GitHub workflow automation

`workspace-cleanup`

Intelligent workspace cleanup with multi-signal detection

Exact duplicate detection via SHA256 hashing (auto-archives older copies)
Three-layer protection: .gitignore + .cleanupignore + hard-coded patterns
Multi-signal analysis: Similarity + timestamps + import/reference detection
Tiered confidence scoring: 100% safe auto-archive, high confidence, low confidence
Two-stage safety: Central archive with 30-day review before permanent deletion
Context-aware scoping: Targeted or recursive based on user intent
Tested & validated: Handles file drift from AI-generated code variations
Reduces AI context pollution from temp files, duplicates, and obsolete versions

Scripts

tmux Orchestration (`scripts/tmux/`)

launch-claude-team.sh - Launch 5-pane tmux session
delegate.sh - Send tasks to specific panes
check-pane.sh - Monitor specific pane
check-all-panes.sh - Monitor all panes
recover-pane.sh - Kill and recover stuck agent

Installation (`scripts/install/`)

install-tmux-orchestration-local.sh - Local project installation

Documentation

Workflow References (`docs/`)

Reference materials for development workflows and patterns.

Installation

Clone this repository to your Claude Code configuration:

# Clone the repository
git clone https://github.com/dbmcco/claude-agent-toolkit ~/.claude/skills/advanced

# Verify installation
ls -la ~/.claude/skills/advanced/skills/
# Should show: orchestrating-tmux-claudes, google-docs-automation, perplexity-research,
#              obsidian-vault-intelligence, reminders-management, linear, github,
#              gemini-cli-extension-porting

# Skills are now available in Claude Code

Configuration

Each skill that requires external services needs specific environment variables configured.

Google Workspace Automation

Required for skills/google-docs-automation/

Create a Google Cloud Project
- Go to Google Cloud Console
- Create a new project or select an existing one
Enable Required APIs
- Navigate to "APIs & Services" > "Library"
- Enable the following APIs:
  - Google Sheets API
  - Google Docs API
  - Google Slides API
  - Google Drive API (for file access)
Create a Service Account
- Go to "APIs & Services" > "Credentials"
- Click "Create Credentials" > "Service Account"
- Fill in service account details and create
- Click on the created service account
- Go to "Keys" tab > "Add Key" > "Create new key"
- Choose JSON format and download the credentials file
Share Documents with Service Account
- Open the service account details
- Copy the service account email (looks like: service-account@project-id.iam.gserviceaccount.com)
- For each Google Doc, Sheet, or Slide you want to access:
  - Click "Share" in the document
  - Paste the service account email
  - Grant "Editor" or "Viewer" permissions as needed
Configure Environment

# In your project or ~/.bashrc
export GOOGLE_SERVICE_ACCOUNT_FILE="/path/to/credentials.json"

Important: Add credentials files to .gitignore:

*.json
.env

Perplexity Research Integration

Required for skills/perplexity-research/

Get API key from Perplexity AI
Configure environment:

# In your project .env or ~/.bashrc
export PERPLEXITY_API_KEY="your_api_key_here"

Obsidian Vault Intelligence

Required for skills/obsidian-vault-intelligence/

Install and configure the dbmcco/obsidian-mcp server:

# Clone and build
git clone https://github.com/dbmcco/obsidian-mcp.git
cd obsidian-mcp
npm install
npm run build

Configuration File Locations:

Claude Code CLI: ~/.config/claude-code/config.json
Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

Add to your configuration file (merge with existing mcps section if present):

{
  "mcps": {
    "obsidian": {
      "command": "node",
      "args": ["/path/to/obsidian-mcp/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

See the obsidian-mcp repository for complete documentation of all 18 available tools.

Apple Reminders Management

Required for skills/reminders-management/

Install and configure the dbmcco/apple-reminders-mcp server:

# Clone and build
git clone https://github.com/dbmcco/apple-reminders-mcp.git
cd apple-reminders-mcp
npm install
npm run build

Configuration File Locations:

Claude Code CLI: ~/.config/claude-code/config.json
Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

Add to your configuration file (merge with existing mcps section if present):

{
  "mcps": {
    "reminders": {
      "command": "node",
      "args": ["/path/to/apple-reminders-mcp/dist/index.js"]
    }
  }
}

See the apple-reminders-mcp repository for complete documentation of all 6 available tools.

Linear Integration

Required for skills/linear/

Get Linear API Key
- Go to Linear Settings
- Create a personal API key
- Copy the key (starts with lin_api_)
Get Team Information
- Find your team ID in Linear settings
- Note your team key (e.g., "LFW", "ENG")
- Note your organization URL slug
Configure Environment

# In your project .env or ~/.bashrc
export LINEAR_API_KEY="lin_api_xxx"
export LINEAR_TEAM_ID="xxx-xxx-xxx"
export LINEAR_TEAM_KEY="YOUR_TEAM"
export LINEAR_ORG_URL="your-org"

Usage:

# Create issue
skills/linear/scripts/linear-create-issue.sh --title "Bug fix" --description "Details"

# List issues
skills/linear/scripts/linear-list-issues.sh --state "In Progress"

# Update issue
skills/linear/scripts/linear-update-issue.sh --issue-id "ID" --state-id "state-done"

See skills/linear/SKILL.md for complete documentation.

GitHub Integration

Required for skills/github/

Create GitHub Personal Access Token
- Go to GitHub Settings > Developer settings > Personal access tokens
- Click "Generate new token (classic)"
- Select scopes: repo, workflow, admin:org (as needed)
- Generate and copy the token
Configure Environment

# In your project .env or ~/.bashrc
export GITHUB_TOKEN="ghp_xxx"

Usage:

# Create issue
skills/github/scripts/gh-create-issue.sh --owner org --repo repo --title "Bug"

# List issues
skills/github/scripts/gh-list-issues.sh --owner org --repo repo --state open

# Create PR
skills/github/scripts/gh-create-pr.sh --owner org --repo repo --title "Feature" --head branch

See skills/github/SKILL.md for complete documentation.

tmux Orchestration

Required for skills/orchestrating-tmux-claudes/

Scripts Included in This Repository

The tmux orchestration scripts are included in this repository under scripts/tmux/:

launch-claude-team.sh - Launch 5-pane tmux session
delegate.sh - Send tasks to specific panes
check-pane.sh - Monitor specific pane output
check-all-panes.sh - Monitor all panes
recover-pane.sh - Kill and recover stuck agents

Installation:

Install tmux:

brew install tmux

Install local scripts (if you cloned to a custom location):

# From the claude-agent-toolkit directory
./scripts/install/install-tmux-orchestration-local.sh

This installs the scripts and makes them available globally.

Role-Based Skills Pattern:

The orchestration skill enforces a coordinator-only role. When launching tmux sessions:

Coordinator Claude (you): Has all skills including orchestration
Worker Claudes (in panes): Should use role-appropriate skills only

See the skill's SKILL.md for role configuration details.

Full Implementation Available:

For the complete implementation with working scripts, see: dbmcco/claude-tmux-orchestration

This repository provides:

✅ Working scripts with automated testing
✅ Quality gates (ESLint, TypeScript, tests, coverage)
✅ Setup wizard for new projects
✅ Automated tests (13 tests passing)
✅ Documentation (installation, testing, troubleshooting)

Quick start:

git clone https://github.com/dbmcco/claude-tmux-orchestration.git
cd claude-tmux-orchestration
./setup.sh

Development

Editing Skills Locally

# Clone the repository
git clone https://github.com/dbmcco/claude-agent-toolkit
cd claude-agent-toolkit

# Edit any skill
vi skills/orchestrating-tmux-claudes/SKILL.md

# Symlink to your Claude Code config for testing
ln -s $(pwd) ~/.claude/skills/advanced

Creating New Skills

Follow the Skill Development Guide for patterns and best practices

Structure

claude-agent-toolkit/
├── skills/
│   ├── orchestrating-tmux-claudes/
│   │   ├── SKILL.md
│   │   └── reference.md
│   ├── google-docs-automation/
│   │   └── SKILL.md
│   ├── keynote-slides/
│   │   ├── SKILL.md
│   │   ├── assets/
│   │   ├── references/
│   │   ├── scripts/
│   │   └── skills/
│   ├── white-paper/
│   │   ├── SKILL.md
│   │   ├── assets/
│   │   ├── references/
│   │   └── scripts/
│   ├── perplexity-research/
│   │   └── SKILL.md
│   ├── obsidian-vault-intelligence/
│   │   └── SKILL.md
│   ├── reminders-management/
│   │   └── SKILL.md
│   ├── linear/
│   │   ├── SKILL.md
│   │   └── scripts/ (5 bash scripts)
│   └── github/
│       ├── SKILL.md
│       └── scripts/ (5 bash scripts)
├── scripts/
│   ├── tmux/
│   └── install/
├── docs/
├── LICENSE
├── .gitignore
└── README.md

Philosophy

Progressive disclosure - Skills load only when relevant
Focused workflows - One skill, one purpose
Quality gates - Enforce best practices
Evidence-based - Verification before claims
Systematic - Process over guessing

Contributing

Contributions welcome! Please:

Fork the repository
Create a feature branch
Follow existing skill structure and patterns
Add clear configuration documentation
Submit a pull request

See docs/skill-development-guide.md for detailed guidance.

Credits

Built with Claude by Anthropic
Built using obra's superpowers framework
Created by Braydon McCormick

License

MIT License - See LICENSE for details

Related Projects

obra/superpowers - Skill framework this toolkit is built on
Claude Code - AI-powered CLI development tool
dbmcco/obsidian-mcp - Obsidian MCP server for vault integration
dbmcco/apple-reminders-mcp - Apple Reminders MCP server
dbmcco/claude-tmux-orchestration - Multi-agent tmux coordination framework

Name		Name	Last commit message	Last commit date
Latest commit History 32 Commits
docs		docs
scripts		scripts
skills		skills
.env.template		.env.template
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
SETUP.md		SETUP.md

License

dbmcco/claude-agent-toolkit

Folders and files

Latest commit

History

Repository files navigation

Claude Agent Toolkit

Overview

Prerequisites

Required

Optional

Skills

orchestrating-tmux-claudes

gemini-cli-extension-porting

google-docs-automation

keynote-slides

white-paper

perplexity-research

obsidian-vault-intelligence

reminders-management

linear

github

workspace-cleanup

Scripts

tmux Orchestration (scripts/tmux/)

Installation (scripts/install/)

Documentation

Workflow References (docs/)

Installation

Configuration

Google Workspace Automation

Perplexity Research Integration

Obsidian Vault Intelligence

Apple Reminders Management

Linear Integration

GitHub Integration

tmux Orchestration

Development

Editing Skills Locally

Creating New Skills

Structure

Philosophy

Contributing

Credits

License

Related Projects

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`orchestrating-tmux-claudes`

`gemini-cli-extension-porting`

`google-docs-automation`

`keynote-slides`

`white-paper`

`perplexity-research`

`obsidian-vault-intelligence`

`reminders-management`

`linear`

`github`

`workspace-cleanup`

tmux Orchestration (`scripts/tmux/`)

Installation (`scripts/install/`)

Workflow References (`docs/`)

Packages