Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/composio-community-skills/badge.svg)](/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

i

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)

  1. # @composiohq/skills
  2. 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.
  3. ## Quick Start
  4. Add Composio skills to your AI assistant:
  5. ```bash
  6. npx skills add composiohq/skills
  7. ```
  8. This command installs the Composio agent skills, giving your AI assistant access to:
  9. - **Tool Router best practices** - Session management, authentication, and framework integration
  10. - **Triggers & Events** - Real-time webhooks and event handling
  11. - **Production patterns** - Security, error handling, and deployment guides
  12. Your AI assistant can now reference these skills when helping you build with Composio!
  13. ## Overview
  14. 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.
  15. ## Structure
  16. ```
  17. skills/
  18. └── composio/
  19. ├── SKILL.md # Main skill overview with rule references
  20. ├── AGENTS.md # Consolidated single-file version (auto-generated)
  21. └── rules/ # Individual rule files
  22. ├── tr-*.md # Tool Router rules
  23. └── triggers-*.md # Trigger rules
  24. ```
  25. ## Available Skills
  26. ### 1. Tool Router (Building Agents)
  27. - User ID best practices for security
  28. - Creating and managing sessions
  29. - Session lifecycle patterns
  30. - Native tools vs MCP integration
  31. - Framework integration (Vercel, OpenAI Agents, LangChain, Claude, CrewAI)
  32. ### 2. Authentication
  33. - Auto authentication in chat
  34. - Manual authorization flows
  35. - Connection management
  36. ### 3. Toolkits & Connection Status
  37. - Querying toolkit availability
  38. - Building connection UIs
  39. ### 4. Advanced Features (Triggers & Events)
  40. - Creating triggers for real-time events
  41. - Subscribing to events (development only)
  42. - Webhook verification (production recommended)
  43. - Managing trigger lifecycle
  44. ## Usage
  45. ### For AI Assistants
  46. Read either:
  47. - **SKILL.md** - Main file with links to individual rules (faster to navigate)
  48. - **AGENTS.md** - Single consolidated file with all content (easier to consume)
  49. ### For Developers
  50. #### Build AGENTS.md
  51. Automatically generate the consolidated AGENTS.md file from all rule files:
  52. ```bash
  53. npm run build:agents
  54. ```
  55. This script:
  56. - Reads SKILL.md for structure
  57. - Extracts all rule references
  58. - Combines individual rule files
  59. - Generates table of contents
  60. - Outputs AGENTS.md with proper formatting
  61. #### Watch Mode
  62. Auto-rebuild AGENTS.md when any file changes:
  63. ```bash
  64. npm run watch:agents
  65. ```
  66. This watches:
  67. - `SKILL.md` for structure changes
  68. - `rules/*.md` for content changes
  69. - Auto-rebuilds on any modification
  70. ## Contributing
  71. ### Adding a New Rule
  72. 1. Create a new markdown file in `skills/composio/rules/`
  73. 2. Use the naming convention:
  74. - `tr-*.md` for Tool Router rules
  75. - `triggers-*.md` for Trigger rules
  76. 3. Include frontmatter:
  77. ```markdown
  78. ---
  79. title: Your Rule Title
  80. impact: CRITICAL|HIGH|MEDIUM|LOW
  81. description: Brief description of what this rule covers
  82. tags: [tool-router, triggers, etc]
  83. ---
  84. # Your Rule Title
  85. Content with ❌ Incorrect and ✅ Correct examples...
  86. ```
  87. 4. Add reference to `SKILL.md` in the appropriate section
  88. 5. Run `npm run build:agents` to regenerate AGENTS.md
  89. 6. Commit all changes (rule file, SKILL.md, and AGENTS.md)
  90. ### Rule Format
  91. Each rule should include:
  92. - **Frontmatter** with metadata
  93. - **❌ Incorrect examples** showing what not to do
  94. - **✅ Correct examples** showing best practices
  95. - **Explanations** of why each approach is better
  96. - **Code examples** in both TypeScript and Python (when applicable)
  97. - **References** to official documentation
  98. ## Build Scripts
  99. The repository includes two scripts in `scripts/`:
  100. ### build-agents.cjs
  101. Generates the consolidated AGENTS.md file:
  102. - Parses SKILL.md for structure
  103. - Reads all rule files
  104. - Combines content with proper formatting
  105. - Generates table of contents
  106. - Adds impact badges and descriptions
  107. ### watch-agents.cjs
  108. Watches for file changes and auto-rebuilds:
  109. - Monitors SKILL.md and rules/ directory
  110. - Triggers rebuild on any .md file change
  111. - Shows real-time build status
  112. ## File Statistics
  113. Current repository stats:
  114. - **14+ rules** covering Tool Router and Triggers
  115. - **150+ KB** of consolidated documentation
  116. - **Both TypeScript and Python** examples throughout
  117. - **Production-ready** patterns and best practices
  118. ## Key Features
  119. ### Tool Router Coverage
  120. - Session management and lifecycle
  121. - User isolation patterns
  122. - Native tools vs MCP comparison
  123. - Framework integration guides
  124. - Connection management
  125. - Authentication flows
  126. ### Triggers Coverage
  127. - Creating trigger instances
  128. - Real-time event subscription
  129. - Webhook verification and security
  130. - Trigger lifecycle management
  131. - Production deployment patterns
  132. ## License
  133. MIT
  134. ## Links
  135. - [Composio Documentation](https://docs.composio.dev)
  136. - [Tool Router API](https://docs.composio.dev/sdk/typescript/api/tool-router)
  137. - [Triggers API](https://docs.composio.dev/sdk/typescript/api/triggers)
  138. - [GitHub Repository](https://github.com/composiohq/skills)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.