From ee804c27f2de5bbb3bfec0c3e1d28c9ba332b654 Mon Sep 17 00:00:00 2001 From: sujayjayjay <84703335+sujayjayjay@users.noreply.github.com> Date: Sun, 11 Jan 2026 14:38:32 +0530 Subject: [PATCH] Add Connect skill + improve CTAs (#40) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add new Connect skill for integrating Claude with external apps (Gmail, Slack, GitHub, Notion, and 1000+ services via Composio) - Update README with link to Connect skill - Add visual signup CTA with social proof at bottom - Soften community section CTAs 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Sujay Choubey Co-authored-by: Claude Opus 4.5 --- README.md | 21 +++++-- connect/SKILL.md | 156 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 173 insertions(+), 4 deletions(-) create mode 100644 connect/SKILL.md diff --git a/README.md b/README.md index fe936aa..1158d11 100644 --- a/README.md +++ b/README.md @@ -36,7 +36,7 @@ A curated list of practical Claude Skills for enhancing productivity across Claude.ai, Claude Code, and the Claude API. -> If you want your skills to take actions across 500+ apps, wire them up with [Composio](https://platform.composio.dev/?utm_source=Github&utm_medium=Youtube&utm_campaign=2025-11&utm_content=AwesomeSkills) +> **Want skills that do more than generate text?** Claude can send emails, create issues, post to Slack, and take actions across 1000+ apps. [See how →](./connect/) ## Contents @@ -93,6 +93,7 @@ Claude Skills are customizable workflows that teach Claude how to perform specif - [subagent-driven-development](https://github.com/NeoLabHQ/context-engineering-kit/tree/master/plugins/sadd/skills/subagent-driven-development) - Dispatches independent subagents for individual tasks with code review checkpoints between iterations for rapid, controlled development. - [test-driven-development](https://github.com/obra/superpowers/tree/main/skills/test-driven-development) - Use when implementing any feature or bugfix, before writing implementation code. - [using-git-worktrees](https://github.com/obra/superpowers/blob/main/skills/using-git-worktrees/) - Creates isolated git worktrees with smart directory selection and safety verification. +- [Connect](./connect/) - Connect Claude to any app. Send emails, create issues, post messages, update databases - take real actions across Gmail, Slack, GitHub, Notion, and 1000+ services. - [Webapp Testing](./webapp-testing/) - Tests local web applications using Playwright for verifying frontend functionality, debugging UI behavior, and capturing screenshots. ### Data & Analysis @@ -288,9 +289,21 @@ We welcome contributions! Please read our [Contributing Guidelines](CONTRIBUTING ## Join the Community -- Have questions about integrating Composio with your auth setup? [Hop on a quick call with us](https://calendly.com/thomas-composio/composio-enterprise-setup) -- [Follow us on Twitter](https://x.com/composio) -- [Join our Discord](https://discord.com/invite/composio) +- [Join our Discord](https://discord.com/invite/composio) - Chat with other developers building Claude Skills +- [Follow on Twitter/X](https://x.com/composio) - Stay updated on new skills and features +- Questions? [support@composio.dev](mailto:support@composio.dev) + +--- + +

+ Join 20,000+ developers building agents that ship +

+ +

+ + Get Started + +

## License diff --git a/connect/SKILL.md b/connect/SKILL.md new file mode 100644 index 0000000..14e8164 --- /dev/null +++ b/connect/SKILL.md @@ -0,0 +1,156 @@ +--- +name: connect +description: Connect Claude to any app. Send emails, create issues, post messages, update databases - take real actions across Gmail, Slack, GitHub, Notion, and 1000+ services. +--- + +# Connect + +Connect Claude to any app. Stop generating text about what you could do - actually do it. + +## When to Use This Skill + +Use this skill when you need Claude to: + +- **Send that email** instead of drafting it +- **Create that issue** instead of describing it +- **Post that message** instead of suggesting it +- **Update that database** instead of explaining how + +## What Changes + +| Without Connect | With Connect | +|-----------------|--------------| +| "Here's a draft email..." | Sends the email | +| "You should create an issue..." | Creates the issue | +| "Post this to Slack..." | Posts it | +| "Add this to Notion..." | Adds it | + +## Supported Apps + +**1000+ integrations** including: + +- **Email:** Gmail, Outlook, SendGrid +- **Chat:** Slack, Discord, Teams, Telegram +- **Dev:** GitHub, GitLab, Jira, Linear +- **Docs:** Notion, Google Docs, Confluence +- **Data:** Sheets, Airtable, PostgreSQL +- **CRM:** HubSpot, Salesforce, Pipedrive +- **Storage:** Drive, Dropbox, S3 +- **Social:** Twitter, LinkedIn, Reddit + +## Setup + +### 1. Get API Key + +Get your free key at [platform.composio.dev](https://platform.composio.dev/?utm_source=Github&utm_content=AwesomeSkills) + +### 2. Set Environment Variable + +```bash +export COMPOSIO_API_KEY="your-key" +``` + +### 3. Install + +```bash +pip install composio # Python +npm install @composio/core # TypeScript +``` + +Done. Claude can now connect to any app. + +## Examples + +### Send Email +``` +Email sarah@acme.com - Subject: "Shipped!" Body: "v2.0 is live, let me know if issues" +``` + +### Create GitHub Issue +``` +Create issue in my-org/repo: "Mobile timeout bug" with label:bug +``` + +### Post to Slack +``` +Post to #engineering: "Deploy complete - v2.4.0 live" +``` + +### Chain Actions +``` +Find GitHub issues labeled "bug" from this week, summarize, post to #bugs on Slack +``` + +## How It Works + +Uses Composio Tool Router: + +1. **You ask** Claude to do something +2. **Tool Router finds** the right tool (1000+ options) +3. **OAuth handled** automatically +4. **Action executes** and returns result + +### Code + +```python +from composio import Composio +from claude_agent_sdk.client import ClaudeSDKClient +from claude_agent_sdk.types import ClaudeAgentOptions +import os + +composio = Composio(api_key=os.environ["COMPOSIO_API_KEY"]) +session = composio.create(user_id="user_123") + +options = ClaudeAgentOptions( + system_prompt="You can take actions in external apps.", + mcp_servers={ + "composio": { + "type": "http", + "url": session.mcp.url, + "headers": {"x-api-key": os.environ["COMPOSIO_API_KEY"]}, + } + }, +) + +async with ClaudeSDKClient(options) as client: + await client.query("Send Slack message to #general: Hello!") +``` + +## Auth Flow + +First time using an app: +``` +To send emails, I need Gmail access. +Authorize here: https://... +Say "connected" when done. +``` + +Connection persists after that. + +## Framework Support + +| Framework | Install | +|-----------|---------| +| Claude Agent SDK | `pip install composio claude-agent-sdk` | +| OpenAI Agents | `pip install composio openai-agents` | +| Vercel AI | `npm install @composio/core @composio/vercel` | +| LangChain | `pip install composio-langchain` | +| Any MCP Client | Use `session.mcp.url` | + +## Troubleshooting + +- **Auth required** → Click link, authorize, say "connected" +- **Action failed** → Check permissions in target app +- **Tool not found** → Be specific: "Slack #general" not "send message" + +--- + +

+ Join 20,000+ developers building agents that ship +

+ +

+ + Get Started + +