{
  "markdown": "# @composiohq/skills\n\nDistributable agent skills for Composio developers. This repository contains comprehensive guides and best practices for building AI agents with Composio's Tool Router and Triggers.\n\n## Quick Start\n\nAdd Composio skills to your AI assistant:\n\n```bash\nnpx skills add composiohq/skills\n```\n\nThis command installs the Composio agent skills, giving your AI assistant access to:\n- **Tool Router best practices** - Session management, authentication, and framework integration\n- **Triggers & Events** - Real-time webhooks and event handling\n- **Production patterns** - Security, error handling, and deployment guides\n\nYour AI assistant can now reference these skills when helping you build with Composio!\n\n## Overview\n\nThis skills repository provides comprehensive guides and best practices for building AI agents with Composio, organized as markdown files that AI assistants can easily reference.\n\n## Structure\n\n```\nskills/\n└── composio/\n    ├── SKILL.md           # Main skill overview with rule references\n    ├── AGENTS.md          # Consolidated single-file version (auto-generated)\n    └── rules/             # Individual rule files\n        ├── tr-*.md        # Tool Router rules\n        └── triggers-*.md  # Trigger rules\n```\n\n## Available Skills\n\n### 1. Tool Router (Building Agents)\n- User ID best practices for security\n- Creating and managing sessions\n- Session lifecycle patterns\n- Native tools vs MCP integration\n- Framework integration (Vercel, OpenAI Agents, LangChain, Claude, CrewAI)\n\n### 2. Authentication\n- Auto authentication in chat\n- Manual authorization flows\n- Connection management\n\n### 3. Toolkits & Connection Status\n- Querying toolkit availability\n- Building connection UIs\n\n### 4. Advanced Features (Triggers & Events)\n- Creating triggers for real-time events\n- Subscribing to events (development only)\n- Webhook verification (production recommended)\n- Managing trigger lifecycle\n\n## Usage\n\n### For AI Assistants\n\nRead either:\n- **SKILL.md** - Main file with links to individual rules (faster to navigate)\n- **AGENTS.md** - Single consolidated file with all content (easier to consume)\n\n### For Developers\n\n#### Build AGENTS.md\n\nAutomatically generate the consolidated AGENTS.md file from all rule files:\n\n```bash\nnpm run build:agents\n```\n\nThis script:\n- Reads SKILL.md for structure\n- Extracts all rule references\n- Combines individual rule files\n- Generates table of contents\n- Outputs AGENTS.md with proper formatting\n\n#### Watch Mode\n\nAuto-rebuild AGENTS.md when any file changes:\n\n```bash\nnpm run watch:agents\n```\n\nThis watches:\n- `SKILL.md` for structure changes\n- `rules/*.md` for content changes\n- Auto-rebuilds on any modification\n\n## Contributing\n\n### Adding a New Rule\n\n1. Create a new markdown file in `skills/composio/rules/`\n2. Use the naming convention:\n   - `tr-*.md` for Tool Router rules\n   - `triggers-*.md` for Trigger rules\n3. Include frontmatter:\n\n```markdown\n---\ntitle: Your Rule Title\nimpact: CRITICAL|HIGH|MEDIUM|LOW\ndescription: Brief description of what this rule covers\ntags: [tool-router, triggers, etc]\n---\n\n# Your Rule Title\n\nContent with ❌ Incorrect and ✅ Correct examples...\n```\n\n4. Add reference to `SKILL.md` in the appropriate section\n5. Run `npm run build:agents` to regenerate AGENTS.md\n6. Commit all changes (rule file, SKILL.md, and AGENTS.md)\n\n### Rule Format\n\nEach rule should include:\n- **Frontmatter** with metadata\n- **❌ Incorrect examples** showing what not to do\n- **✅ Correct examples** showing best practices\n- **Explanations** of why each approach is better\n- **Code examples** in both TypeScript and Python (when applicable)\n- **References** to official documentation\n\n## Build Scripts\n\nThe repository includes two scripts in `scripts/`:\n\n### build-agents.cjs\n\nGenerates the consolidated AGENTS.md file:\n- Parses SKILL.md for structure\n- Reads all rule files\n- Combines content with proper formatting\n- Generates table of contents\n- Adds impact badges and descriptions\n\n### watch-agents.cjs\n\nWatches for file changes and auto-rebuilds:\n- Monitors SKILL.md and rules/ directory\n- Triggers rebuild on any .md file change\n- Shows real-time build status\n\n## File Statistics\n\nCurrent repository stats:\n- **14+ rules** covering Tool Router and Triggers\n- **150+ KB** of consolidated documentation\n- **Both TypeScript and Python** examples throughout\n- **Production-ready** patterns and best practices\n\n## Key Features\n\n### Tool Router Coverage\n- Session management and lifecycle\n- User isolation patterns\n- Native tools vs MCP comparison\n- Framework integration guides\n- Connection management\n- Authentication flows\n\n### Triggers Coverage\n- Creating trigger instances\n- Real-time event subscription\n- Webhook verification and security\n- Trigger lifecycle management\n- Production deployment patterns\n\n## License\n\nMIT\n\n## Links\n\n- [Composio Documentation](https://docs.composio.dev)\n- [Tool Router API](https://docs.composio.dev/sdk/typescript/api/tool-router)\n- [Triggers API](https://docs.composio.dev/sdk/typescript/api/triggers)\n- [GitHub Repository](https://github.com/composiohq/skills)\n",
  "bytes": 5080,
  "sha": "e1a05f5f4b59bffe99c5fbd8efe5ac1f772790347a99f7fc69b1ed7d674c1946",
  "repo_slug": "composio-community/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_composio_community_skills_skill_creator_ed3d6edb/readme"
}