Distributable agent skills for Composio developers. This repository contains comprehensive guides and best practices for building AI agents with Composio's Tool Router and Triggers.
Add Composio skills to your AI assistant:
npx skills add composiohq/skillsThis command installs the Composio agent skills, giving your AI assistant access to:
- Tool Router best practices - Session management, authentication, and framework integration
- Triggers & Events - Real-time webhooks and event handling
- Production patterns - Security, error handling, and deployment guides
Your AI assistant can now reference these skills when helping you build with Composio!
This skills repository provides comprehensive guides and best practices for building AI agents with Composio, organized as markdown files that AI assistants can easily reference.
skills/
└── composio/
├── SKILL.md # Main skill overview with rule references
├── AGENTS.md # Consolidated single-file version (auto-generated)
└── rules/ # Individual rule files
├── tr-*.md # Tool Router rules
└── triggers-*.md # Trigger rules
- User ID best practices for security
- Creating and managing sessions
- Session lifecycle patterns
- Native tools vs MCP integration
- Framework integration (Vercel, OpenAI Agents, LangChain, Claude, CrewAI)
- Auto authentication in chat
- Manual authorization flows
- Connection management
- Querying toolkit availability
- Building connection UIs
- Creating triggers for real-time events
- Subscribing to events (development only)
- Webhook verification (production recommended)
- Managing trigger lifecycle
Read either:
- SKILL.md - Main file with links to individual rules (faster to navigate)
- AGENTS.md - Single consolidated file with all content (easier to consume)
Automatically generate the consolidated AGENTS.md file from all rule files:
npm run build:agentsThis script:
- Reads SKILL.md for structure
- Extracts all rule references
- Combines individual rule files
- Generates table of contents
- Outputs AGENTS.md with proper formatting
Auto-rebuild AGENTS.md when any file changes:
npm run watch:agentsThis watches:
SKILL.mdfor structure changesrules/*.mdfor content changes- Auto-rebuilds on any modification
- Create a new markdown file in
skills/composio/rules/ - Use the naming convention:
tr-*.mdfor Tool Router rulestriggers-*.mdfor Trigger rules
- Include frontmatter:
---
title: Your Rule Title
impact: CRITICAL|HIGH|MEDIUM|LOW
description: Brief description of what this rule covers
tags: [tool-router, triggers, etc]
---
# Your Rule Title
Content with ❌ Incorrect and ✅ Correct examples...- Add reference to
SKILL.mdin the appropriate section - Run
npm run build:agentsto regenerate AGENTS.md - Commit all changes (rule file, SKILL.md, and AGENTS.md)
Each rule should include:
- Frontmatter with metadata
- ❌ Incorrect examples showing what not to do
- ✅ Correct examples showing best practices
- Explanations of why each approach is better
- Code examples in both TypeScript and Python (when applicable)
- References to official documentation
The repository includes two scripts in scripts/:
Generates the consolidated AGENTS.md file:
- Parses SKILL.md for structure
- Reads all rule files
- Combines content with proper formatting
- Generates table of contents
- Adds impact badges and descriptions
Watches for file changes and auto-rebuilds:
- Monitors SKILL.md and rules/ directory
- Triggers rebuild on any .md file change
- Shows real-time build status
Current repository stats:
- 14+ rules covering Tool Router and Triggers
- 150+ KB of consolidated documentation
- Both TypeScript and Python examples throughout
- Production-ready patterns and best practices
- Session management and lifecycle
- User isolation patterns
- Native tools vs MCP comparison
- Framework integration guides
- Connection management
- Authentication flows
- Creating trigger instances
- Real-time event subscription
- Webhook verification and security
- Trigger lifecycle management
- Production deployment patterns
MIT