skills
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.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/composio-community-skills)HTML
<a href="/listings/composio-community-skills"><img src="/api/listings/composio-community-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Add Composio skills to your AI assistant:
npx skills add composiohq/skills
This 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!
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 189 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # @composiohq/skills
- 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.
- ## Quick Start
- Add Composio skills to your AI assistant:
- ```bash
- npx skills add composiohq/skills
- ```
- This 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!
- ## Overview
- 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.
- ## Structure
- ```
- 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
- ```
- ## Available Skills
- ### 1. Tool Router (Building Agents)
- - 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)
- ### 2. Authentication
- - Auto authentication in chat
- - Manual authorization flows
- - Connection management
- ### 3. Toolkits & Connection Status
- - Querying toolkit availability
- - Building connection UIs
- ### 4. Advanced Features (Triggers & Events)
- - Creating triggers for real-time events
- - Subscribing to events (development only)
- - Webhook verification (production recommended)
- - Managing trigger lifecycle
- ## Usage
- ### For AI Assistants
- 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)
- ### For Developers
- #### Build AGENTS.md
- Automatically generate the consolidated AGENTS.md file from all rule files:
- ```bash
- npm run build:agents
- ```
- This script:
- - Reads SKILL.md for structure
- - Extracts all rule references
- - Combines individual rule files
- - Generates table of contents
- - Outputs AGENTS.md with proper formatting
- #### Watch Mode
- Auto-rebuild AGENTS.md when any file changes:
- ```bash
- npm run watch:agents
- ```
- This watches:
- - `SKILL.md` for structure changes
- - `rules/*.md` for content changes
- - Auto-rebuilds on any modification
- ## Contributing
- ### Adding a New Rule
- 1. Create a new markdown file in `skills/composio/rules/`
- 2. Use the naming convention:
- - `tr-*.md` for Tool Router rules
- - `triggers-*.md` for Trigger rules
- 3. Include frontmatter:
- ```markdown
- ---
- 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...
- ```
- 4. Add reference to `SKILL.md` in the appropriate section
- 5. Run `npm run build:agents` to regenerate AGENTS.md
- 6. Commit all changes (rule file, SKILL.md, and AGENTS.md)
- ### Rule Format
- 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
- ## Build Scripts
- The repository includes two scripts in `scripts/`:
- ### build-agents.cjs
- 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
- ### watch-agents.cjs
- 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
- ## File Statistics
- 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
- ## Key Features
- ### Tool Router Coverage
- - Session management and lifecycle
- - User isolation patterns
- - Native tools vs MCP comparison
- - Framework integration guides
- - Connection management
- - Authentication flows
- ### Triggers Coverage
- - Creating trigger instances
- - Real-time event subscription
- - Webhook verification and security
- - Trigger lifecycle management
- - Production deployment patterns
- ## License
- MIT
- ## Links
- - [Composio Documentation](https://docs.composio.dev)
- - [Tool Router API](https://docs.composio.dev/sdk/typescript/api/tool-router)
- - [Triggers API](https://docs.composio.dev/sdk/typescript/api/triggers)
- - [GitHub Repository](https://github.com/composiohq/skills)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.