Code Health

Runs a comprehensive code health scan using the Centinela (QA) agent.

When to Use This Skill

• Periodic codebase hygiene check
• Before a release to ensure no dead code or unresolved debt
• After a large refactoring to verify cleanliness
• When onboarding to understand current code quality

What This Skill Does

1. Runs the SIGN IN checklist
2. Scans for dead code (unused imports, variables, functions, commented-out blocks, unreachable code)
3. Checks for outdated and vulnerable dependencies
4. Detects code smells (long functions, deep nesting, duplication)
5. Audits TODO/FIXME comments for issue references
6. Runs the Scan Complete checklist (TIME OUT)
7. Writes findings to docs/reviews/code-health-{date}.md
8. Prepares findings handoff to Dev agent

How to Use

Basic Usage

/code-health

Example

User: /code-health

Output: A code health report at docs/reviews/code-health-2026-02-23.md with:

• Dead code findings (verified, not false positives)
• Dependency status and vulnerabilities
• Code smell inventory
• TODO/FIXME audit
• Prioritized findings: Critical > Warning > Suggestion

Tips

• Scans all source directories, not just src/ — includes tests/ and config files
• Previous scan findings are compared to track recurring issues
• Findings are verified to avoid false positives from dynamic imports or plugins

Feature Spec

Creates a complete product feature specification using the Prometeo (PM) agent.

When to Use This Skill

• Defining a new feature or product requirement
• Writing user stories with acceptance criteria
• Planning product work that needs a structured spec
• Documenting business requirements before implementation

What This Skill Does

1. Runs the SIGN IN checklist (identity, task, memory review)
2. Researches existing specs to avoid conflicts
3. Creates a comprehensive spec at docs/specs/{feature-name}.md
4. Runs the Spec Completion checklist (TIME OUT)
5. Prepares a structured handoff to the Dev agent
6. Runs the SIGN OUT checklist (memory update, deliverables)

How to Use

Basic Usage

/feature-spec user authentication with JWT tokens

Detailed Usage

/feature-spec multi-tenant billing system with Stripe integration

Example

User: /feature-spec webhook event system

Output: A complete spec at docs/specs/webhook-event-system.md containing:

• Problem statement and success metrics
• User stories with GIVEN/WHEN/THEN acceptance criteria
• In-scope and out-of-scope items
• Dependencies, risks, and open questions
• Handoff notes for the Dev agent

Tips

• Be specific about the feature scope in your description
• The agent will ask clarifying questions rather than guess
• Review the generated spec before passing to implementation

Implement Feature

Implements a feature from its specification using the Forja (Dev) agent.

When to Use This Skill

• A feature spec has been approved and is ready for implementation
• You need architecture design, code, and tests for a defined feature
• Translating product requirements into working software

What This Skill Does

1. Runs the SIGN IN checklist and verifies the spec handoff
2. Designs architecture (creates ADR if needed)
3. Defines interfaces/contracts, then implements in src/
4. Writes tests in tests/ (unit + integration)
5. Runs the Implementation Complete checklist (TIME OUT 1)
6. Runs the Pre-Delivery checklist (TIME OUT 2)
7. Prepares structured handoff to QA agent
8. Runs the SIGN OUT checklist

How to Use

Basic Usage

/implement-feature webhook-event-system

With Spec Reference

/implement-feature docs/specs/webhook-event-system.md

Example

User: /implement-feature user-authentication

Output:

• Implementation in src/ with all acceptance criteria met
• Tests in tests/ covering critical paths
• ADR if significant architecture decisions were made
• Handoff notes for QA: files changed, how to test, known limitations

Tips

• Ensure the feature spec exists before running this skill
• The agent creates an ADR for any significant architecture decisions
• Two TIME OUT checkpoints ensure both correctness and delivery cleanliness

Release Check

Runs pre-release verification using the Centinela (QA) agent. This is the highest-stakes checklist in the system.

When to Use This Skill

• Before any release to production
• Before tagging a version
• As a final quality gate after all features are implemented and reviewed

What This Skill Does

1. Runs the SIGN IN checklist
2. TIME OUT 1 — Documentation and Debt Check: verifies CHANGELOG, TECH_DEBT, specs, and docs
3. TIME OUT 2 — Testing and Quality Gate: runs all tests, code health scan, quality verification
4. TIME OUT 3 — Security and Release Gate: runs security audit, security verification, release readiness
5. Writes release assessment to docs/reviews/release-check-{version}.md
6. Issues final verdict: READY FOR RELEASE or BLOCKED (with specific reasons)

How to Use

Basic Usage

/release-check v1.2.0

Example

User: /release-check v2.0.0

Output: A release assessment at docs/reviews/release-check-v2.0.0.md with:

• Documentation completeness check
• Test results and quality gate status
• Security audit summary
• Final verdict with specific blocking reasons if any

Tips

• This is the last line of defense before code reaches users
• A blocked release here prevents issues from reaching production
• Three TIME OUT checkpoints cover docs, quality, and security independently

Review Findings

Addresses and fixes QA findings using the Forja (Dev) agent.

When to Use This Skill

• After receiving a code review from Centinela (QA)
• When a review report has findings that need to be addressed
• Fixing critical and warning issues before re-verification

What This Skill Does

1. Runs the SIGN IN checklist
2. Reads the review report and understands each finding's root cause
3. Plans fix order: Critical first, then Warnings
4. Implements fixes with updated tests for each finding
5. Scans for dead code after all fixes
6. Runs Implementation Complete and Pre-Delivery checklists (TIME OUT)
7. Verifies every Critical finding addressed, every Warning addressed or deferred with justification
8. Prepares a fix report for QA re-verification

How to Use

Basic Usage

/review-findings

With Specific Review

/review-findings docs/reviews/user-auth-review.md

Example

User: /review-findings docs/reviews/webhook-system-review.md

Output:

• All Critical findings fixed with tests
• All Warning findings fixed or explicitly deferred with justification
• Fix report documenting what was changed and why
• Ready for QA re-verification

Tips

• If no review is specified, the most recent review in docs/reviews/ is used
• The agent understands root causes before writing any fix
• Conflicting fixes are identified and planned around during the pre-fix phase

Security Audit

Performs a deep security audit using the Centinela (QA) agent.

When to Use This Skill

• Before a release to verify security posture
• After significant code changes that touch authentication, authorization, or data handling
• Periodic security review of the codebase
• When adding new dependencies or external integrations

What This Skill Does

1. Runs the SIGN IN checklist
2. Performs OWASP Top 10 systematic check (A01-A10)
3. Scans for hardcoded secrets, API keys, tokens, and connection strings
4. Audits dependencies for known CVEs
5. Checks smart contracts if Solidity is present (reentrancy, overflow, access control)
6. Runs Security Verification and Quality Verification checklists (TIME OUT)
7. Issues verdict and writes report to docs/reviews/security-audit-{date}.md
8. Prepares findings handoff to Dev agent

How to Use

Basic Usage

/security-audit

Scoped Audit

/security-audit src/auth/ src/api/

Example

User: /security-audit src/payments/

Output: A security audit report at docs/reviews/security-audit-2026-02-23.md with:

• OWASP Top 10 findings organized by severity
• Secrets scan results
• Dependency vulnerability report
• Verdict: APPROVED or CHANGES REQUIRED
• Fix order recommendation for the Dev agent

Tips

• If no scope is specified, the entire src/ directory is audited
• Critical findings trigger the Non-Normal emergency checklist
• The agent will never attempt to fix vulnerabilities — only document them

uc-taskmanager Init

Initialize the current project for uc-taskmanager pipeline execution.

Steps

1. Create works/ directory

if works/ does not exist:
  create works/
  report: ✓ works/ directory created
else:
  report: - works/ already exists

2. Configure Bash Permissions

Ask the user first: "에이전트에 필요한 Bash 권한을 .claude/settings.local.json에 자동 설정할까요? (recommended) [Y/n]"

If the user approves (or says yes/Y/확인):

Read .claude/settings.local.json (create if not exists). Merge the following permissions into permissions.allow array — skip any that already exist (do not duplicate):

[
  "Read(/**)",
  "Edit(/**)",
  "Write(/**)",
  "Read(**)",
  "Edit(**)",
  "Write(**)",
  "Bash(ls:*)",
  "Bash(cat:*)",
  "Bash(mkdir:*)",
  "Bash(basename:*)",
  "Bash(find:*)",
  "Bash(wc:*)",
  "Bash(sort:*)",
  "Bash(tail:*)",
  "Bash(head:*)",
  "Bash(echo:*)",
  "Bash(printf:*)",
  "Bash(grep:*)",
  "Bash(sed:*)",
  "Bash(cut:*)",
  "Bash(tr:*)",
  "Bash(node:*)",
  "Bash(npm run:*)",
  "Bash(npm test:*)",
  "Bash(bun run:*)",
  "Bash(yarn:*)",
  "Bash(cargo:*)",
  "Bash(go build:*)",
  "Bash(go test:*)",
  "Bash(python:*)",
  "Bash(ruff:*)",
  "Bash(make:*)",
  "Bash(git:*)",
  "Bash(curl:*)"
]

Preserve any existing entries in permissions.allow and permissions.deny — only add missing ones.

if permissions added:
  report: ✓ {N} permissions added to .claude/settings.local.json (total: {T})
else if skipped by user:
  report: - Skipped permission setup
else:
  report: - All permissions already configured

3. Summary

After all steps, show a summary:

uc-taskmanager initialized!

  ✓ works/ directory ready
  ✓ Bash permissions configured

  Next: Type [new-feature] Add a hello world feature

Arguments

$ARGUMENTS

WORK-PIPELINE Trigger

When the user's message starts with a [] tag, start the WORK-PIPELINE by reading ../skills/sdd-pipeline/references/agent-flow.md and following the orchestration flow.

Trigger Detection

Any message starting with [...] triggers this pipeline:

• [new-feature], [enhancement], [bugfix], [new-work], [WORK start]
• Or any custom tag in square brackets

References Directory (CRITICAL)

When this skill is triggered, Claude Code provides the "Base directory for this skill" as an absolute path. Derive the REFERENCES_DIR from it:

REFERENCES_DIR = {Base directory}/../sdd-pipeline/references

You MUST pass this absolute path to every sub-agent invocation (specifier, planner, scheduler, builder, verifier, committer). Include it at the top of the prompt text:

REFERENCES_DIR={absolute_path}

Sub-agents need this path to read their reference files. Without it, they cannot find the files and will loop.

Pipeline Flow

1. Call specifier agent — analyzes the requirement, creates works/WORK-NN/Requirement.md, determines execution-mode (direct/pipeline/full)
2. ⛔ STOP — Present the specifier's output summary to the user and WAIT for explicit approval. Do NOT call the next agent until the user approves. Show what was created (Requirement.md, PLAN.md if direct mode, TASK files) and ask "Proceed?"
3. Follow the execution-mode returned by specifier:
   • direct: call builder → committer
   • pipeline: call builder → verifier → committer in sequence
   • full: call planner → ⛔ STOP for 2nd approval → scheduler → [builder → verifier → committer] × N

Auto Mode

If the user's message ends with "auto" or "자동으로", skip ALL approval steps and execute the entire pipeline automatically. This is the ONLY case where approval gates can be skipped.

Arguments

User requirement: $ARGUMENTS

WORK Status

Check and report the current status of WORKs and TASKs.

How to Check

1. Read works/WORK-LIST.md for the master index of all WORKs
2. For a specific WORK, read works/WORK-NN/PROGRESS.md for TASK-level progress
3. For a specific TASK, read works/WORK-NN/TASK-NN_result.md for completion details

Status Values

Display Format

WORK Status
  WORK-01: User Authentication    ✅ 5/5 completed
  WORK-02: Payment Integration    🔄 2/4 in progress
  WORK-03: Admin Dashboard        ⬜ 0/6 pending

Arguments

Query: $ARGUMENTS

ActiveCampaign Automation via Rube MCP

Automate ActiveCampaign CRM and marketing automation operations through Composio's ActiveCampaign toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/active_campaign

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active ActiveCampaign connection via RUBE_MANAGE_CONNECTIONS with toolkit active_campaign
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit active_campaign
3. If connection is not ACTIVE, follow the returned auth link to complete ActiveCampaign authentication
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Create and Find Contacts

When to use: User wants to create new contacts or look up existing ones

Tool sequence:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Search for an existing contact [Optional]
2. ACTIVE_CAMPAIGN_CREATE_CONTACT - Create a new contact [Required]

Key parameters for find:

• email: Search by email address
• id: Search by ActiveCampaign contact ID
• phone: Search by phone number

Key parameters for create:

• email: Contact email address (required)
• first_name: Contact first name
• last_name: Contact last name
• phone: Contact phone number
• organization_name: Contact's organization
• job_title: Contact's job title
• tags: Comma-separated list of tags to apply

Pitfalls:

• email is the only required field for contact creation
• Phone search uses a general search parameter internally; it may return partial matches
• When combining email and phone in FIND_CONTACT, results are filtered client-side
• Tags provided during creation are applied immediately
• Creating a contact with an existing email may update the existing contact

2. Manage Contact Tags

When to use: User wants to add or remove tags from contacts

Tool sequence:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Find contact by email or ID [Prerequisite]
2. ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG - Add or remove tags [Required]

Key parameters:

• action: 'Add' or 'Remove' (required)
• tags: Tag names as comma-separated string or array of strings (required)
• contact_id: Contact ID (provide this or contact_email)
• contact_email: Contact email address (alternative to contact_id)

Pitfalls:

• action values are capitalized: 'Add' or 'Remove' (not lowercase)
• Tags can be a comma-separated string ('tag1, tag2') or an array (['tag1', 'tag2'])
• Either contact_id or contact_email must be provided; contact_id takes precedence
• Adding a tag that does not exist creates it automatically
• Removing a non-existent tag is a no-op (does not error)

3. Manage List Subscriptions

When to use: User wants to subscribe or unsubscribe contacts from lists

Tool sequence:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Find the contact [Prerequisite]
2. ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION - Subscribe or unsubscribe [Required]

Key parameters:

• action: 'subscribe' or 'unsubscribe' (required)
• list_id: Numeric list ID string (required)
• email: Contact email address (provide this or contact_id)
• contact_id: Numeric contact ID string (alternative to email)

Pitfalls:

• action values are lowercase: 'subscribe' or 'unsubscribe'
• list_id is a numeric string (e.g., '2'), not the list name
• List IDs can be retrieved via the GET /api/3/lists endpoint (not available as a Composio tool; use the ActiveCampaign UI)
• If both email and contact_id are provided, contact_id takes precedence
• Unsubscribing changes status to '2' (unsubscribed) but the relationship record persists

4. Add Contacts to Automations

When to use: User wants to enroll a contact in an automation workflow

Tool sequence:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Verify contact exists [Prerequisite]
2. ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION - Enroll contact in automation [Required]

Key parameters:

• contact_email: Email of the contact to enroll (required)
• automation_id: ID of the target automation (required)

Pitfalls:

• The contact must already exist in ActiveCampaign
• Automations can only be created through the ActiveCampaign UI, not via API
• automation_id must reference an existing, active automation
• The tool performs a two-step process: lookup contact by email, then enroll
• Automation IDs can be found in the ActiveCampaign UI or via GET /api/3/automations

5. Create Contact Tasks

When to use: User wants to create follow-up tasks associated with contacts

Tool sequence:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Find the contact to associate the task with [Prerequisite]
2. ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK - Create the task [Required]

Key parameters:

• relid: Contact ID to associate the task with (required)
• duedate: Due date in ISO 8601 format with timezone (required, e.g., '2025-01-15T14:30:00-05:00')
• dealTasktype: Task type ID based on available types (required)
• title: Task title
• note: Task description/content
• assignee: User ID to assign the task to
• edate: End date in ISO 8601 format (must be later than duedate)
• status: 0 for incomplete, 1 for complete

Pitfalls:

• duedate must be a valid ISO 8601 datetime with timezone offset; do NOT use placeholder values
• edate must be later than duedate
• dealTasktype is a string ID referencing task types configured in ActiveCampaign
• relid is the numeric contact ID, not the email address
• assignee is a user ID; resolve user names to IDs via the ActiveCampaign UI

Common Patterns

Contact Lookup Flow

1. Call ACTIVE_CAMPAIGN_FIND_CONTACT with email
2. If found, extract contact ID for subsequent operations
3. If not found, create contact with ACTIVE_CAMPAIGN_CREATE_CONTACT
4. Use contact ID for tags, subscriptions, or automations

Bulk Contact Tagging

1. For each contact, call ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG
2. Use contact_email to avoid separate lookup calls
3. Batch with reasonable delays to respect rate limits

ID Resolution

Contact email -> Contact ID:

1. Call ACTIVE_CAMPAIGN_FIND_CONTACT with email
2. Extract id from the response

Known Pitfalls

Action Capitalization:

• Tag actions: 'Add', 'Remove' (capitalized)
• Subscription actions: 'subscribe', 'unsubscribe' (lowercase)
• Mixing up capitalization causes errors

ID Types:

• Contact IDs: numeric strings (e.g., '123')
• List IDs: numeric strings
• Automation IDs: numeric strings
• All IDs should be passed as strings, not integers

Automations:

• Automations cannot be created via API; only enrollment is possible
• Automation must be active to accept new contacts
• Enrolling a contact already in the automation may have no effect

Rate Limits:

• ActiveCampaign API has rate limits per account
• Implement backoff on 429 responses
• Batch operations should be spaced appropriately

Response Parsing:

• Response data may be nested under data or data.data
• Parse defensively with fallback patterns
• Contact search may return multiple results; match by email for accuracy

Quick Reference

Powered by Composio

Agent Analytics — Analytics your agent can actually use

You are adding analytics tracking using Agent Analytics — the analytics platform your AI agent can actually use. Built for developers who ship lots of projects and want their AI agent to track, analyze, experiment, and optimize across all of them.

Website: agentanalytics.sh GitHub: Agent-Analytics/agent-analytics Docs: docs.agentanalytics.sh

When to Use This Skill

• User wants to add analytics tracking to a website or app
• User wants to check how their projects are doing (traffic, conversions, engagement)
• User wants to run A/B experiments on headlines, CTAs, or flows
• User wants funnel analysis, retention cohorts, or traffic breakdowns
• User asks "how's my site doing?" or "are people visiting?"

Philosophy

You are NOT Mixpanel. Don't track everything. Track only what answers: "Is this project alive and growing?"

For a typical site, that's 3-5 custom events max on top of automatic page views.

First-time setup

Get an API key: Sign up at agentanalytics.sh and generate a key from the dashboard. Alternatively, self-host the open-source version from GitHub.

If the project doesn't have tracking yet:

# 1. Login (one time — uses your API key)
npx @agent-analytics/cli login --token aak_YOUR_API_KEY

# 2. Create the project (returns a project write token)
npx @agent-analytics/cli create my-site --domain https://mysite.com

# 3. Add the snippet using the returned token
# 4. Deploy, click around, verify:
npx @agent-analytics/cli events my-site

The create command returns a project write token — use it as data-token in the snippet. This is separate from your API key (which is for reading/querying).

Step 1: Add the tracking snippet

The create command returns a tracking snippet with your project token — add it before </body>. It auto-tracks page_view events with path, referrer, browser, OS, device, screen size, and UTM params. You do NOT need to add custom page_view events.

Step 1b: Discover existing events (existing projects)

If tracking is already set up, check what events and property keys are already in use so you match the naming:

npx @agent-analytics/cli properties-received PROJECT_NAME

Step 2: Add custom events to important actions

Use onclick handlers on the elements that matter:

<a href="..." onclick="window.aa?.track('EVENT_NAME', {id: 'ELEMENT_ID'})">

Standard events for 80% of SaaS sites

Pick the ones that apply. Most sites need 2-4:

What NOT to track

• Every link or button (too noisy)
• Scroll depth (not actionable)
• Form field interactions (too granular)
• Footer links (low signal)

Property naming rules

• Use snake_case: hero_get_started not heroGetStarted
• The id property identifies WHICH element: short, descriptive
• Name IDs as section_action: hero_signup, pricing_pro, nav_dashboard

Step 2b: Run A/B experiments

Experiments let you test which variant of a page element converts better. The full lifecycle is API-driven — no dashboard UI needed.

Creating an experiment

npx @agent-analytics/cli experiments create my-site \
  --name signup_cta --variants control,new_cta --goal signup

Implementing variants

Declarative (recommended): Use data-aa-experiment and data-aa-variant-{key} HTML attributes. Original content is the control. The tracker swaps text for assigned variants automatically.

<h1 data-aa-experiment="signup_cta" data-aa-variant-new_cta="Start Free Trial">Sign Up</h1>

Programmatic (complex cases): Use window.aa?.experiment(name, variants) — deterministic, same user always gets same variant.

Checking results

npx @agent-analytics/cli experiments get exp_abc123

Returns Bayesian probability_best, lift, and a recommendation. The system needs ~100 exposures per variant before results are significant.

Step 3: Test immediately

After adding tracking, verify it works:

# Click around, then check:
npx @agent-analytics/cli events PROJECT_NAME
# Events appear within seconds.

CLI Reference

All commands use npx @agent-analytics/cli:

# Setup
login --token aak_YOUR_KEY           # Save API key (one time)
projects                              # List all projects
create my-site --domain https://...   # Create project

# Real-time
live                                  # Live TUI dashboard across ALL projects
live my-site                          # Live view for one project

# Analytics
stats my-site --days 7                # Overview: events, users, daily trends
insights my-site --period 7d          # Period-over-period comparison
breakdown my-site --property path --event page_view --limit 10  # Top pages/referrers/UTM
pages my-site --type entry            # Landing page performance & bounce rates
sessions-dist my-site                 # Session engagement histogram
heatmap my-site                       # Peak hours & busiest days
events my-site --days 30              # Raw event log
sessions my-site                      # Individual session records
properties my-site                    # Discover event names & property keys
funnel my-site --steps "page_view,signup,purchase"  # Funnel drop-off
retention my-site --period week --cohorts 8         # Cohort retention

# A/B experiments
experiments list my-site
experiments create my-site --name signup_cta --variants control,new_cta --goal signup
experiments get exp_abc123
experiments complete exp_abc123 --winner new_cta

Which endpoint for which question

For any "how is X doing" question, always call insights first — it's the single most useful endpoint.

Examples

Track custom events via window.aa?.track():

window.aa?.track('cta_click', {id: 'hero_get_started'});
window.aa?.track('signup', {method: 'github'});
window.aa?.track('feature_used', {feature: 'create_project'});
window.aa?.track('checkout', {plan: 'pro'});

What this skill does NOT do

• No GUI dashboards — your agent IS the dashboard (or use live for a real-time TUI)
• No user management or billing
• No PII stored — IP addresses are not logged or retained. Privacy-first by design

Airtable Automation via Rube MCP

Automate Airtable operations through Composio's Airtable toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/airtable

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Airtable connection via RUBE_MANAGE_CONNECTIONS with toolkit airtable
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit airtable
3. If connection is not ACTIVE, follow the returned auth link to complete Airtable auth
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Create and Manage Records

When to use: User wants to create, read, update, or delete records

Tool sequence:

1. AIRTABLE_LIST_BASES - Discover available bases [Prerequisite]
2. AIRTABLE_GET_BASE_SCHEMA - Inspect table structure [Prerequisite]
3. AIRTABLE_LIST_RECORDS - List/filter records [Optional]
4. AIRTABLE_CREATE_RECORD / AIRTABLE_CREATE_RECORDS - Create records [Optional]
5. AIRTABLE_UPDATE_RECORD / AIRTABLE_UPDATE_MULTIPLE_RECORDS - Update records [Optional]
6. AIRTABLE_DELETE_RECORD / AIRTABLE_DELETE_MULTIPLE_RECORDS - Delete records [Optional]

Key parameters:

• baseId: Base ID (starts with 'app', e.g., 'appXXXXXXXXXXXXXX')
• tableIdOrName: Table ID (starts with 'tbl') or table name
• fields: Object mapping field names to values
• recordId: Record ID (starts with 'rec') for updates/deletes
• filterByFormula: Airtable formula for filtering
• typecast: Set true for automatic type conversion

Pitfalls:

• pageSize capped at 100; uses offset pagination; changing filters between pages can skip/duplicate rows
• CREATE_RECORDS hard limit of 10 records per request; chunk larger imports
• Field names are CASE-SENSITIVE and must match schema exactly
• 422 UNKNOWN_FIELD_NAME when field names are wrong; 403 for permission issues
• INVALID_MULTIPLE_CHOICE_OPTIONS may require typecast=true

2. Search and Filter Records

When to use: User wants to find specific records using formulas

Tool sequence:

1. AIRTABLE_GET_BASE_SCHEMA - Verify field names and types [Prerequisite]
2. AIRTABLE_LIST_RECORDS - Query with filterByFormula [Required]
3. AIRTABLE_GET_RECORD - Get full record details [Optional]

Key parameters:

• filterByFormula: Airtable formula (e.g., {Status}='Done')
• sort: Array of sort objects
• fields: Array of field names to return
• maxRecords: Max total records across all pages
• offset: Pagination cursor from previous response

Pitfalls:

• Field names in formulas must be wrapped in {} and match schema exactly
• String values must be quoted: {Status}='Active' not {Status}=Active
• 422 INVALID_FILTER_BY_FORMULA for bad syntax or non-existent fields
• Airtable rate limit: ~5 requests/second per base; handle 429 with Retry-After

3. Manage Fields and Schema

When to use: User wants to create or modify table fields

Tool sequence:

1. AIRTABLE_GET_BASE_SCHEMA - Inspect current schema [Prerequisite]
2. AIRTABLE_CREATE_FIELD - Create a new field [Optional]
3. AIRTABLE_UPDATE_FIELD - Rename/describe a field [Optional]
4. AIRTABLE_UPDATE_TABLE - Update table metadata [Optional]

Key parameters:

• name: Field name
• type: Field type (singleLineText, number, singleSelect, etc.)
• options: Type-specific options (choices for select, precision for number)
• description: Field description

Pitfalls:

• UPDATE_FIELD only changes name/description, NOT type/options; create a replacement field and migrate
• Computed fields (formula, rollup, lookup) cannot be created via API
• 422 when type options are missing or malformed

4. Manage Comments

When to use: User wants to view or add comments on records

Tool sequence:

1. AIRTABLE_LIST_COMMENTS - List comments on a record [Required]

Key parameters:

• baseId: Base ID
• tableIdOrName: Table identifier
• recordId: Record ID (17 chars, starts with 'rec')
• pageSize: Comments per page (max 100)

Pitfalls:

• Record IDs must be exactly 17 characters starting with 'rec'

Common Patterns

Airtable Formula Syntax

Comparison:

• {Status}='Done' - Equals
• {Priority}>1 - Greater than
• {Name}!='' - Not empty

Functions:

• AND({A}='x', {B}='y') - Both conditions
• OR({A}='x', {A}='y') - Either condition
• FIND('test', {Name})>0 - Contains text
• IS_BEFORE({Due Date}, TODAY()) - Date comparison

Escape rules:

• Single quotes in values: double them ({Name}='John''s Company')

Pagination

• Set pageSize (max 100)
• Check response for offset string
• Pass offset to next request unchanged
• Keep filters/sorts/view stable between pages

Known Pitfalls

ID Formats:

• Base IDs: appXXXXXXXXXXXXXX (17 chars)
• Table IDs: tblXXXXXXXXXXXXXX (17 chars)
• Record IDs: recXXXXXXXXXXXXXX (17 chars)
• Field IDs: fldXXXXXXXXXXXXXX (17 chars)

Batch Limits:

• CREATE_RECORDS: max 10 per request
• UPDATE_MULTIPLE_RECORDS: max 10 per request
• DELETE_MULTIPLE_RECORDS: max 10 per request

Quick Reference

Powered by Composio

Amplitude Automation via Rube MCP

Automate Amplitude product analytics through Composio's Amplitude toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/amplitude

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Amplitude connection via RUBE_MANAGE_CONNECTIONS with toolkit amplitude
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit amplitude
3. If connection is not ACTIVE, follow the returned auth link to complete Amplitude authentication
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Send Events

When to use: User wants to track events or send event data to Amplitude

Tool sequence:

1. AMPLITUDE_SEND_EVENTS - Send one or more events to Amplitude [Required]

Key parameters:

• events: Array of event objects, each containing:
  • event_type: Name of the event (e.g., 'page_view', 'purchase')
  • user_id: Unique user identifier (required if no device_id)
  • device_id: Device identifier (required if no user_id)
  • event_properties: Object with custom event properties
  • user_properties: Object with user properties to set
  • time: Event timestamp in milliseconds since epoch

Pitfalls:

• At least one of user_id or device_id is required per event
• event_type is required for every event; cannot be empty
• time must be in milliseconds (13-digit epoch), not seconds
• Batch limit applies; check schema for maximum events per request
• Events are processed asynchronously; successful API response does not mean data is immediately queryable

2. Get User Activity

When to use: User wants to view event history for a specific user

Tool sequence:

1. AMPLITUDE_FIND_USER - Find user by ID or property [Prerequisite]
2. AMPLITUDE_GET_USER_ACTIVITY - Retrieve user's event stream [Required]

Key parameters:

• user: Amplitude internal user ID (from FIND_USER)
• offset: Pagination offset for event list
• limit: Maximum number of events to return

Pitfalls:

• user parameter requires Amplitude's internal user ID, NOT your application's user_id
• Must call FIND_USER first to resolve your user_id to Amplitude's internal ID
• Activity is returned in reverse chronological order by default
• Large activity histories require pagination via offset

3. Find and Identify Users

When to use: User wants to look up users or set user properties

Tool sequence:

1. AMPLITUDE_FIND_USER - Search for a user by various identifiers [Required]
2. AMPLITUDE_IDENTIFY - Set or update user properties [Optional]

Key parameters:

• For FIND_USER:
  • user: Search term (user_id, email, or Amplitude ID)
• For IDENTIFY:
  • user_id: Your application's user identifier
  • device_id: Device identifier (alternative to user_id)
  • user_properties: Object with $set, $unset, $add, $append operations

Pitfalls:

• FIND_USER searches across user_id, device_id, and Amplitude ID
• IDENTIFY uses special property operations ($set, $unset, $add, $append)
• $set overwrites existing values; $setOnce only sets if not already set
• At least one of user_id or device_id is required for IDENTIFY
• User property changes are eventually consistent; not immediate

4. Manage Cohorts

When to use: User wants to list cohorts, view cohort details, or update cohort membership

Tool sequence:

1. AMPLITUDE_LIST_COHORTS - List all saved cohorts [Required]
2. AMPLITUDE_GET_COHORT - Get detailed cohort information [Optional]
3. AMPLITUDE_UPDATE_COHORT_MEMBERSHIP - Add/remove users from a cohort [Optional]
4. AMPLITUDE_CHECK_COHORT_STATUS - Check async cohort operation status [Optional]

Key parameters:

• For LIST_COHORTS: No required parameters
• For GET_COHORT: cohort_id (from list results)
• For UPDATE_COHORT_MEMBERSHIP:
  • cohort_id: Target cohort ID
  • memberships: Object with add and/or remove arrays of user IDs
• For CHECK_COHORT_STATUS: request_id from update response

Pitfalls:

• Cohort IDs are required for all cohort-specific operations
• UPDATE_COHORT_MEMBERSHIP is asynchronous; use CHECK_COHORT_STATUS to verify
• request_id from the update response is needed for status checking
• Maximum membership changes per request may be limited; chunk large updates
• Only behavioral cohorts support API membership updates

5. Browse Event Categories

When to use: User wants to discover available event types and categories in Amplitude

Tool sequence:

1. AMPLITUDE_GET_EVENT_CATEGORIES - List all event categories [Required]

Key parameters:

• No required parameters; returns all configured event categories

Pitfalls:

• Categories are configured in Amplitude UI; API provides read access
• Event names within categories are case-sensitive
• Use these categories to validate event_type values before sending events

Common Patterns

ID Resolution

Application user_id -> Amplitude internal ID:

1. Call AMPLITUDE_FIND_USER with user=your_user_id
2. Extract Amplitude's internal user ID from response
3. Use internal ID for GET_USER_ACTIVITY

Cohort name -> Cohort ID:

1. Call AMPLITUDE_LIST_COHORTS
2. Find cohort by name in results
3. Extract id for cohort operations

User Property Operations

Amplitude IDENTIFY supports these property operations:

• $set: Set property value (overwrites existing)
• $setOnce: Set only if property not already set
• $add: Increment numeric property
• $append: Append to list property
• $unset: Remove property entirely

Example structure:

{
  "user_properties": {
    "$set": {"plan": "premium", "company": "Acme"},
    "$add": {"login_count": 1}
  }
}

Async Operation Pattern

For cohort membership updates:

1. Call AMPLITUDE_UPDATE_COHORT_MEMBERSHIP -> get request_id
2. Call AMPLITUDE_CHECK_COHORT_STATUS with request_id
3. Repeat step 2 until status is 'complete' or 'error'

Known Pitfalls

User IDs:

• Amplitude has its own internal user IDs separate from your application's
• FIND_USER resolves your IDs to Amplitude's internal IDs
• GET_USER_ACTIVITY requires Amplitude's internal ID, not your user_id

Event Timestamps:

• Must be in milliseconds since epoch (13 digits)
• Seconds (10 digits) will be interpreted as very old dates
• Omitting timestamp uses server receive time

Rate Limits:

• Event ingestion has throughput limits per project
• Batch events where possible to reduce API calls
• Cohort membership updates have async processing limits

Response Parsing:

• Response data may be nested under data key
• User activity returns events in reverse chronological order
• Cohort lists may include archived cohorts; check status field
• Parse defensively with fallbacks for optional fields

Quick Reference

Powered by Composio

Artifacts Builder

To build powerful frontend claude.ai artifacts, follow these steps:

1. Initialize the frontend repo using scripts/init-artifact.sh
2. Develop your artifact by editing the generated code
3. Bundle all code into a single HTML file using scripts/bundle-artifact.sh
4. Display artifact to user
5. (Optional) Test the artifact

Stack: React 18 + TypeScript + Vite + Parcel (bundling) + Tailwind CSS + shadcn/ui

Design & Style Guidelines

VERY IMPORTANT: To avoid what is often referred to as "AI slop", avoid using excessive centered layouts, purple gradients, uniform rounded corners, and Inter font.

Quick Start

Step 1: Initialize Project

Run the initialization script to create a new React project:

bash scripts/init-artifact.sh <project-name>
cd <project-name>

This creates a fully configured project with:

• ✅ React + TypeScript (via Vite)
• ✅ Tailwind CSS 3.4.1 with shadcn/ui theming system
• ✅ Path aliases (@/) configured
• ✅ 40+ shadcn/ui components pre-installed
• ✅ All Radix UI dependencies included
• ✅ Parcel configured for bundling (via .parcelrc)
• ✅ Node 18+ compatibility (auto-detects and pins Vite version)

Step 2: Develop Your Artifact

To build the artifact, edit the generated files. See Common Development Tasks below for guidance.

Step 3: Bundle to Single HTML File

To bundle the React app into a single HTML artifact:

bash scripts/bundle-artifact.sh

This creates bundle.html - a self-contained artifact with all JavaScript, CSS, and dependencies inlined. This file can be directly shared in Claude conversations as an artifact.

Requirements: Your project must have an index.html in the root directory.

What the script does:

• Installs bundling dependencies (parcel, @parcel/config-default, parcel-resolver-tspaths, html-inline)
• Creates .parcelrc config with path alias support
• Builds with Parcel (no source maps)
• Inlines all assets into single HTML using html-inline

Step 4: Share Artifact with User

Finally, share the bundled HTML file in conversation with the user so they can view it as an artifact.

Step 5: Testing/Visualizing the Artifact (Optional)

Note: This is a completely optional step. Only perform if necessary or requested.

To test/visualize the artifact, use available tools (including other Skills or built-in tools like Playwright or Puppeteer). In general, avoid testing the artifact upfront as it adds latency between the request and when the finished artifact can be seen. Test later, after presenting the artifact, if requested or if issues arise.

Reference

• shadcn/ui components: https://ui.shadcn.com/docs/components

Asana Automation via Rube MCP

Automate Asana operations through Composio's Asana toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/asana

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Asana connection via RUBE_MANAGE_CONNECTIONS with toolkit asana
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit asana
3. If connection is not ACTIVE, follow the returned auth link to complete Asana OAuth
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Manage Tasks

When to use: User wants to create, search, list, or organize tasks

Tool sequence:

1. ASANA_GET_MULTIPLE_WORKSPACES - Get workspace ID [Prerequisite]
2. ASANA_SEARCH_TASKS_IN_WORKSPACE - Search tasks [Optional]
3. ASANA_GET_TASKS_FROM_A_PROJECT - List project tasks [Optional]
4. ASANA_CREATE_A_TASK - Create a new task [Optional]
5. ASANA_GET_A_TASK - Get task details [Optional]
6. ASANA_CREATE_SUBTASK - Create a subtask [Optional]
7. ASANA_GET_TASK_SUBTASKS - List subtasks [Optional]

Key parameters:

• workspace: Workspace GID (required for search/creation)
• projects: Array of project GIDs to add task to
• name: Task name
• notes: Task description
• assignee: Assignee (user GID or email)
• due_on: Due date (YYYY-MM-DD)

Pitfalls:

• Workspace GID is required for most operations; get it first
• Task GIDs are returned as strings, not integers
• Search is workspace-scoped, not project-scoped

2. Manage Projects and Sections

When to use: User wants to create projects, manage sections, or organize tasks

Tool sequence:

1. ASANA_GET_WORKSPACE_PROJECTS - List workspace projects [Optional]
2. ASANA_GET_A_PROJECT - Get project details [Optional]
3. ASANA_CREATE_A_PROJECT - Create a new project [Optional]
4. ASANA_GET_SECTIONS_IN_PROJECT - List sections [Optional]
5. ASANA_CREATE_SECTION_IN_PROJECT - Create a new section [Optional]
6. ASANA_ADD_TASK_TO_SECTION - Move task to section [Optional]
7. ASANA_GET_TASKS_FROM_A_SECTION - List tasks in section [Optional]

Key parameters:

• project_gid: Project GID
• name: Project or section name
• workspace: Workspace GID for creation
• task: Task GID for section assignment
• section: Section GID

Pitfalls:

• Projects belong to workspaces; workspace GID is needed for creation
• Sections are ordered within a project
• DUPLICATE_PROJECT creates a copy with optional task inclusion

3. Manage Teams and Users

When to use: User wants to list teams, team members, or workspace users

Tool sequence:

1. ASANA_GET_TEAMS_IN_WORKSPACE - List workspace teams [Optional]
2. ASANA_GET_USERS_FOR_TEAM - List team members [Optional]
3. ASANA_GET_USERS_FOR_WORKSPACE - List all workspace users [Optional]
4. ASANA_GET_CURRENT_USER - Get authenticated user [Optional]
5. ASANA_GET_MULTIPLE_USERS - Get multiple user details [Optional]

Key parameters:

• workspace_gid: Workspace GID
• team_gid: Team GID

Pitfalls:

• Users are workspace-scoped
• Team membership requires the team GID

4. Parallel Operations

When to use: User needs to perform bulk operations efficiently

Tool sequence:

1. ASANA_SUBMIT_PARALLEL_REQUESTS - Execute multiple API calls in parallel [Required]

Key parameters:

• actions: Array of action objects with method, path, and data

Pitfalls:

• Each action must be a valid Asana API call
• Failed individual requests do not roll back successful ones

Common Patterns

ID Resolution

Workspace name -> GID:

1. Call ASANA_GET_MULTIPLE_WORKSPACES
2. Find workspace by name
3. Extract gid field

Project name -> GID:

1. Call ASANA_GET_WORKSPACE_PROJECTS with workspace GID
2. Find project by name
3. Extract gid field

Pagination

• Asana uses cursor-based pagination with offset parameter
• Check for next_page in response
• Pass offset from next_page.offset for next request

Known Pitfalls

GID Format:

• All Asana IDs are strings (GIDs), not integers
• GIDs are globally unique identifiers

Workspace Scoping:

• Most operations require a workspace context
• Tasks, projects, and users are workspace-scoped

Quick Reference

Powered by Composio

AuraKit v6

Sonnet Amplified fullstack development engine for Claude Code.

Overview

AuraKit transforms a single /aura command into a complete production-grade development pipeline with 34 modes, OWASP-complete security, and 75% token reduction.

Key Features

• Sonnet Amplifier — 5-step forced reasoning for Opus-level quality from Sonnet
• 34 Modes — BUILD/FIX/CLEAN/DEPLOY/REVIEW + 28 extended (TDD, PM, QA, ORCHESTRATE, etc.)
• SEC-01~15 — OWASP Top 10 complete inline security rules
• 13 Runtime Hooks — Zero-token security enforcement (security-scan, bash-guard, bloat-check, auto-format, etc.)
• Tiered Model — ECO (Sonnet) / PRO (Opus) / MAX (full Opus) with automatic model selection
• 75% Token Reduction — Verified: 82KB → 20KB per BUILD load
• 10 Language Reviewers — TypeScript, Python, Go, Java, Rust, Kotlin, C++, Swift, PHP, Perl
• 5 Framework Patterns — Next.js, Remix, Astro, Nuxt, SvelteKit
• Instinct Learning — Project patterns auto-saved and reused across sessions
• 8-Language UI — Korean, English, Japanese, Chinese, Spanish, French, German, Italian

Install

npx @smorky85/aurakit
# or
git clone https://github.com/smorky850612/Aurakit.git && cd Aurakit && bash install.sh

Usage

/aura 로그인 기능 만들어줘      # BUILD (auto-detect)
/aura fix: TypeError in auth   # FIX mode
/aura review:                  # 4-agent parallel review
/aura! 버튼 색상 변경           # QUICK mode (~60% fewer tokens)
/aura pro 결제 시스템 구현      # PRO tier (Opus builder)

Links

• GitHub: https://github.com/smorky850612/Aurakit
• npm: https://www.npmjs.com/package/@smorky85/aurakit

BambooHR Automation via Rube MCP

Automate BambooHR human resources operations through Composio's BambooHR toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/bamboohr

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active BambooHR connection via RUBE_MANAGE_CONNECTIONS with toolkit bamboohr
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit bamboohr
3. If connection is not ACTIVE, follow the returned auth link to complete BambooHR authentication
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. List and Search Employees

When to use: User wants to find employees or get the full employee directory

Tool sequence:

1. BAMBOOHR_GET_ALL_EMPLOYEES - Get the employee directory [Required]
2. BAMBOOHR_GET_EMPLOYEE - Get detailed info for a specific employee [Optional]

Key parameters:

• For GET_ALL_EMPLOYEES: No required parameters; returns directory
• For GET_EMPLOYEE:
  • id: Employee ID (numeric)
  • fields: Comma-separated list of fields to return (e.g., 'firstName,lastName,department,jobTitle')

Pitfalls:

• Employee IDs are numeric integers
• GET_ALL_EMPLOYEES returns basic directory info; use GET_EMPLOYEE for full details
• The fields parameter controls which fields are returned; omitting it may return minimal data
• Common fields: firstName, lastName, department, division, jobTitle, workEmail, status
• Inactive/terminated employees may be included; check status field

2. Track Employee Changes

When to use: User wants to detect recent employee data changes for sync or auditing

Tool sequence:

1. BAMBOOHR_EMPLOYEE_GET_CHANGED - Get employees with recent changes [Required]

Key parameters:

• since: ISO 8601 datetime string for change detection threshold
• type: Type of changes to check (e.g., 'inserted', 'updated', 'deleted')

Pitfalls:

• since parameter is required; use ISO 8601 format (e.g., '2024-01-15T00:00:00Z')
• Returns IDs of changed employees, not full employee data
• Must call GET_EMPLOYEE separately for each changed employee's details
• Useful for incremental sync workflows; cache the last sync timestamp

3. Manage Time-Off

When to use: User wants to view time-off balances, request time off, or manage requests

Tool sequence:

1. BAMBOOHR_GET_META_TIME_OFF_TYPES - List available time-off types [Prerequisite]
2. BAMBOOHR_GET_TIME_OFF_BALANCES - Check current balances [Optional]
3. BAMBOOHR_GET_TIME_OFF_REQUESTS - List existing requests [Optional]
4. BAMBOOHR_CREATE_TIME_OFF_REQUEST - Submit a new request [Optional]
5. BAMBOOHR_UPDATE_TIME_OFF_REQUEST - Modify or approve/deny a request [Optional]

Key parameters:

• For balances: employeeId, time-off type ID
• For requests: start, end (date range), employeeId
• For creation:
  • employeeId: Employee to request for
  • timeOffTypeId: Type ID from GET_META_TIME_OFF_TYPES
  • start: Start date (YYYY-MM-DD)
  • end: End date (YYYY-MM-DD)
  • amount: Number of days/hours
  • notes: Optional notes for the request
• For update: requestId, status ('approved', 'denied', 'cancelled')

Pitfalls:

• Time-off type IDs are numeric; resolve via GET_META_TIME_OFF_TYPES first
• Date format is 'YYYY-MM-DD' for start and end dates
• Balances may be in hours or days depending on company configuration
• Request status updates require appropriate permissions (manager/admin)
• Creating a request does NOT auto-approve it; separate approval step needed

4. Update Employee Information

When to use: User wants to modify employee profile data

Tool sequence:

1. BAMBOOHR_GET_EMPLOYEE - Get current employee data [Prerequisite]
2. BAMBOOHR_UPDATE_EMPLOYEE - Update employee fields [Required]

Key parameters:

• id: Employee ID (numeric, required)
• Field-value pairs for the fields to update (e.g., department, jobTitle, workPhone)

Pitfalls:

• Only fields included in the request are updated; others remain unchanged
• Some fields are read-only and cannot be updated via API
• Field names must match BambooHR's expected field names exactly
• Updates are audited; changes appear in the employee's change history
• Verify current values with GET_EMPLOYEE before updating to avoid overwriting

5. Manage Dependents and Benefits

When to use: User wants to view employee dependents or benefit coverage

Tool sequence:

1. BAMBOOHR_DEPENDENTS_GET_ALL - List all dependents [Required]
2. BAMBOOHR_BENEFIT_GET_COVERAGES - Get benefit coverage details [Optional]

Key parameters:

• For dependents: Optional employeeId filter
• For benefits: Depends on schema; check RUBE_SEARCH_TOOLS for current parameters

Pitfalls:

• Dependent data includes sensitive PII; handle with appropriate care
• Benefit coverages may include multiple plan types per employee
• Not all BambooHR plans include benefits administration; check account features
• Data access depends on API key permissions

Common Patterns

ID Resolution

Employee name -> Employee ID:

1. Call BAMBOOHR_GET_ALL_EMPLOYEES
2. Find employee by name in directory results
3. Extract id (numeric) for detailed operations

Time-off type name -> Type ID:

1. Call BAMBOOHR_GET_META_TIME_OFF_TYPES
2. Find type by name (e.g., 'Vacation', 'Sick Leave')
3. Extract id for time-off requests

Incremental Sync Pattern

For keeping external systems in sync with BambooHR:

1. Store last_sync_timestamp
2. Call BAMBOOHR_EMPLOYEE_GET_CHANGED with since=last_sync_timestamp
3. For each changed employee ID, call BAMBOOHR_GET_EMPLOYEE
4. Process updates in external system
5. Update last_sync_timestamp

Time-Off Workflow

1. GET_META_TIME_OFF_TYPES -> find type ID
2. GET_TIME_OFF_BALANCES -> verify available balance
3. CREATE_TIME_OFF_REQUEST -> submit request
4. UPDATE_TIME_OFF_REQUEST -> approve/deny (manager action)

Known Pitfalls

Employee IDs:

• Always numeric integers
• Resolve names to IDs via GET_ALL_EMPLOYEES
• Terminated employees retain their IDs

Date Formats:

• Time-off dates: 'YYYY-MM-DD'
• Change detection: ISO 8601 with timezone
• Inconsistent formats between endpoints; check each endpoint's schema

Permissions:

• API key permissions determine accessible fields and operations
• Some operations require admin or manager-level access
• Time-off approvals require appropriate role permissions

Sensitive Data:

• Employee data includes PII (names, addresses, SSN, etc.)
• Handle all responses with appropriate security measures
• Dependent data is especially sensitive

Rate Limits:

• BambooHR API has rate limits per API key
• Bulk operations should be throttled
• GET_ALL_EMPLOYEES is more efficient than individual GET_EMPLOYEE calls

Response Parsing:

• Response data may be nested under data key
• Employee fields vary based on fields parameter
• Empty fields may be omitted or returned as null
• Parse defensively with fallbacks

Quick Reference

Powered by Composio

Basecamp Automation via Rube MCP

Automate Basecamp operations including project management, to-do list creation, task management, message board posting, people management, and to-do group organization through Composio's Basecamp toolkit.

Toolkit docs: composio.dev/toolkits/basecamp

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Basecamp connection via RUBE_MANAGE_CONNECTIONS with toolkit basecamp
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit basecamp
3. If connection is not ACTIVE, follow the returned auth link to complete Basecamp OAuth
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Manage To-Do Lists and Tasks

When to use: User wants to create to-do lists, add tasks, or organize work within a Basecamp project

Tool sequence:

1. BASECAMP_GET_PROJECTS - List projects to find the target bucket_id [Prerequisite]
2. BASECAMP_GET_BUCKETS_TODOSETS - Get the to-do set within a project [Prerequisite]
3. BASECAMP_GET_BUCKETS_TODOSETS_TODOLISTS - List existing to-do lists to avoid duplicates [Optional]
4. BASECAMP_POST_BUCKETS_TODOSETS_TODOLISTS - Create a new to-do list in a to-do set [Required for list creation]
5. BASECAMP_GET_BUCKETS_TODOLISTS - Get details of a specific to-do list [Optional]
6. BASECAMP_POST_BUCKETS_TODOLISTS_TODOS - Create a to-do item in a to-do list [Required for task creation]
7. BASECAMP_CREATE_TODO - Alternative tool for creating individual to-dos [Alternative]
8. BASECAMP_GET_BUCKETS_TODOLISTS_TODOS - List to-dos within a to-do list [Optional]

Key parameters for creating to-do lists:

• bucket_id: Integer project/bucket ID (from GET_PROJECTS)
• todoset_id: Integer to-do set ID (from GET_BUCKETS_TODOSETS)
• name: Title of the to-do list (required)
• description: HTML-formatted description (supports Rich text)

Key parameters for creating to-dos:

• bucket_id: Integer project/bucket ID
• todolist_id: Integer to-do list ID
• content: What the to-do is for (required)
• description: HTML details about the to-do
• assignee_ids: Array of integer person IDs
• due_on: Due date in YYYY-MM-DD format
• starts_on: Start date in YYYY-MM-DD format
• notify: Boolean to notify assignees (defaults to false)
• completion_subscriber_ids: Person IDs notified upon completion

Pitfalls:

• A project (bucket) can contain multiple to-do sets; selecting the wrong todoset_id creates lists in the wrong section
• Always check existing to-do lists before creating to avoid near-duplicate names
• Success payloads include user-facing URLs (app_url, app_todos_url); prefer returning these over raw IDs
• All IDs (bucket_id, todoset_id, todolist_id) are integers, not strings
• Descriptions support HTML formatting only, not Markdown

2. Post and Manage Messages

When to use: User wants to post messages to a project message board or update existing messages

Tool sequence:

1. BASECAMP_GET_PROJECTS - Find the target project and bucket_id [Prerequisite]
2. BASECAMP_GET_MESSAGE_BOARD - Get the message board ID for the project [Prerequisite]
3. BASECAMP_CREATE_MESSAGE - Create a new message on the board [Required]
4. BASECAMP_POST_BUCKETS_MESSAGE_BOARDS_MESSAGES - Alternative message creation tool [Fallback]
5. BASECAMP_GET_MESSAGE - Read a specific message by ID [Optional]
6. BASECAMP_PUT_BUCKETS_MESSAGES - Update an existing message [Optional]

Key parameters:

• bucket_id: Integer project/bucket ID
• message_board_id: Integer message board ID (from GET_MESSAGE_BOARD)
• subject: Message title (required)
• content: HTML body of the message
• status: Set to "active" to publish immediately
• category_id: Message type classification (optional)
• subscriptions: Array of person IDs to notify; omit to notify all project members

Pitfalls:

• status="draft" can produce HTTP 400; use status="active" as the reliable option
• bucket_id and message_board_id must belong to the same project; mismatches fail or misroute
• Message content supports HTML tags only; not Markdown
• Updates via PUT_BUCKETS_MESSAGES replace the entire body -- include the full corrected content, not just a diff
• Prefer app_url from the response for user-facing confirmation links
• Both CREATE_MESSAGE and POST_BUCKETS_MESSAGE_BOARDS_MESSAGES do the same thing; use CREATE_MESSAGE first and fall back to POST if it fails

3. Manage People and Access

When to use: User wants to list people, manage project access, or add new users

Tool sequence:

1. BASECAMP_GET_PEOPLE - List all people visible to the current user [Required]
2. BASECAMP_GET_PROJECTS - Find the target project [Prerequisite]
3. BASECAMP_LIST_PROJECT_PEOPLE - List people on a specific project [Required]
4. BASECAMP_GET_PROJECTS_PEOPLE - Alternative to list project members [Alternative]
5. BASECAMP_PUT_PROJECTS_PEOPLE_USERS - Grant or revoke project access [Required for access changes]

Key parameters for PUT_PROJECTS_PEOPLE_USERS:

• project_id: Integer project ID
• grant: Array of integer person IDs to add to the project
• revoke: Array of integer person IDs to remove from the project
• create: Array of objects with name, email_address, and optional company_name, title for new users
• At least one of grant, revoke, or create must be provided

Pitfalls:

• Person IDs are integers; always resolve names to IDs via GET_PEOPLE first
• project_id for people management is the same as bucket_id for other operations
• LIST_PROJECT_PEOPLE and GET_PROJECTS_PEOPLE are near-identical; use either
• Creating users via create also grants them project access in one step

4. Organize To-Dos with Groups

When to use: User wants to organize to-dos within a list into color-coded groups

Tool sequence:

1. BASECAMP_GET_PROJECTS - Find the target project [Prerequisite]
2. BASECAMP_GET_BUCKETS_TODOLISTS - Get the to-do list details [Prerequisite]
3. BASECAMP_GET_TODOLIST_GROUPS - List existing groups in a to-do list [Optional]
4. BASECAMP_GET_BUCKETS_TODOLISTS_GROUPS - Alternative group listing [Alternative]
5. BASECAMP_POST_BUCKETS_TODOLISTS_GROUPS - Create a new group in a to-do list [Required]
6. BASECAMP_CREATE_TODOLIST_GROUP - Alternative group creation tool [Alternative]

Key parameters:

• bucket_id: Integer project/bucket ID
• todolist_id: Integer to-do list ID
• name: Group title (required)
• color: Visual color identifier -- one of: white, red, orange, yellow, green, blue, aqua, purple, gray, pink, brown
• status: Filter for listing -- "archived" or "trashed" (omit for active groups)

Pitfalls:

• POST_BUCKETS_TODOLISTS_GROUPS and CREATE_TODOLIST_GROUP are near-identical; use either
• Color values must be from the fixed palette; arbitrary hex/rgb values are not supported
• Groups are sub-sections within a to-do list, not standalone entities

5. Browse and Inspect Projects

When to use: User wants to list projects, get project details, or explore project structure

Tool sequence:

1. BASECAMP_GET_PROJECTS - List all active projects [Required]
2. BASECAMP_GET_PROJECT - Get comprehensive details for a specific project [Optional]
3. BASECAMP_GET_PROJECTS_BY_PROJECT_ID - Alternative project detail retrieval [Alternative]

Key parameters:

• status: Filter by "archived" or "trashed"; omit for active projects
• project_id: Integer project ID for detailed retrieval

Pitfalls:

• Projects are sorted by most recently created first
• The response includes a dock array with tools (todoset, message_board, etc.) and their IDs
• Use the dock tool IDs to find todoset_id, message_board_id, etc. for downstream operations

Common Patterns

ID Resolution

Basecamp uses a hierarchical ID structure. Always resolve top-down:

• Project (bucket_id): BASECAMP_GET_PROJECTS -- find by name, capture the id
• To-do set (todoset_id): Found in project dock or via BASECAMP_GET_BUCKETS_TODOSETS
• Message board (message_board_id): Found in project dock or via BASECAMP_GET_MESSAGE_BOARD
• To-do list (todolist_id): BASECAMP_GET_BUCKETS_TODOSETS_TODOLISTS
• People (person_id): BASECAMP_GET_PEOPLE or BASECAMP_LIST_PROJECT_PEOPLE
• Note: bucket_id and project_id refer to the same entity in different contexts

Pagination

Basecamp uses page-based pagination on list endpoints:

• Response headers or body may indicate more pages available
• GET_PROJECTS, GET_BUCKETS_TODOSETS_TODOLISTS, and list endpoints return paginated results
• Continue fetching until no more results are returned

Content Formatting

• All rich text fields use HTML, not Markdown
• Wrap content in <div> tags; use <strong>, <em>, <ul>, <ol>, <li>, <a> etc.
• Example: <div><strong>Important:</strong> Complete by Friday</div>

Known Pitfalls

ID Formats

• All Basecamp IDs are integers, not strings or UUIDs
• bucket_id = project_id (same entity, different parameter names across tools)
• To-do set IDs, to-do list IDs, and message board IDs are found in the project's dock array
• Person IDs are integers; resolve names via GET_PEOPLE before operations

Status Field

• status="draft" for messages can cause HTTP 400; always use status="active"
• Project/to-do list status filters: "archived", "trashed", or omit for active

Content Format

• HTML only, never Markdown
• Updates replace the entire body, not a partial diff
• Invalid HTML tags may be silently stripped

Rate Limits

• Basecamp API has rate limits; space out rapid sequential requests
• Large projects with many to-dos should be paginated carefully

URL Handling

• Prefer app_url from API responses for user-facing links
• Do not reconstruct Basecamp URLs manually from IDs

Quick Reference

Powered by Composio

Bitbucket Automation via Rube MCP

Automate Bitbucket operations including repository management, pull request workflows, branch operations, issue tracking, and workspace administration through Composio's Bitbucket toolkit.

Toolkit docs: composio.dev/toolkits/bitbucket

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Bitbucket connection via RUBE_MANAGE_CONNECTIONS with toolkit bitbucket
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit bitbucket
3. If connection is not ACTIVE, follow the returned auth link to complete Bitbucket OAuth
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Manage Pull Requests

When to use: User wants to create, review, or inspect pull requests

Tool sequence:

1. BITBUCKET_LIST_WORKSPACES - Discover accessible workspaces [Prerequisite]
2. BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE - Find the target repository [Prerequisite]
3. BITBUCKET_LIST_BRANCHES - Verify source and destination branches exist [Prerequisite]
4. BITBUCKET_CREATE_PULL_REQUEST - Create a new PR with title, source branch, and optional reviewers [Required]
5. BITBUCKET_LIST_PULL_REQUESTS - List PRs filtered by state (OPEN, MERGED, DECLINED) [Optional]
6. BITBUCKET_GET_PULL_REQUEST - Get full details of a specific PR by ID [Optional]
7. BITBUCKET_GET_PULL_REQUEST_DIFF - Fetch unified diff for code review [Optional]
8. BITBUCKET_GET_PULL_REQUEST_DIFFSTAT - Get changed files with lines added/removed [Optional]

Key parameters:

• workspace: Workspace slug or UUID (required for all operations)
• repo_slug: URL-friendly repository name
• source_branch: Branch with changes to merge
• destination_branch: Target branch (defaults to repo main branch if omitted)
• reviewers: List of objects with uuid field for reviewer assignment
• state: Filter for LIST_PULL_REQUESTS - OPEN, MERGED, or DECLINED
• max_chars: Truncation limit for GET_PULL_REQUEST_DIFF to handle large diffs

Pitfalls:

• reviewers expects an array of objects with uuid key, NOT usernames: [{"uuid": "{...}"}]
• UUID format must include curly braces: {123e4567-e89b-12d3-a456-426614174000}
• destination_branch defaults to the repo's main branch if omitted, which may not be main
• pull_request_id is an integer for GET/DIFF operations but comes back as part of PR listing
• Large diffs can overwhelm context; always set max_chars (e.g., 50000) on GET_PULL_REQUEST_DIFF

2. Manage Repositories and Workspaces

When to use: User wants to list, create, or delete repositories or explore workspaces

Tool sequence:

1. BITBUCKET_LIST_WORKSPACES - List all accessible workspaces [Required]
2. BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE - List repos with optional BBQL filtering [Required]
3. BITBUCKET_CREATE_REPOSITORY - Create a new repo with language, privacy, and project settings [Optional]
4. BITBUCKET_DELETE_REPOSITORY - Permanently delete a repository (irreversible) [Optional]
5. BITBUCKET_LIST_WORKSPACE_MEMBERS - List members for reviewer assignment or access checks [Optional]

Key parameters:

• workspace: Workspace slug (find via LIST_WORKSPACES)
• repo_slug: URL-friendly name for create/delete
• q: BBQL query filter (e.g., name~"api", project.key="PROJ", is_private=true)
• role: Filter repos by user role: member, contributor, admin, owner
• sort: Sort field with optional - prefix for descending (e.g., -updated_on)
• is_private: Boolean for repository visibility (defaults to true)
• project_key: Bitbucket project key; omit to use workspace's oldest project

Pitfalls:

• BITBUCKET_DELETE_REPOSITORY is irreversible and does not affect forks
• BBQL string values MUST be enclosed in double quotes: name~"my-repo" not name~my-repo
• repository is NOT a valid BBQL field; use name instead
• Default pagination is 10 results; set pagelen explicitly for complete listings
• CREATE_REPOSITORY defaults to private; set is_private: false for public repos

3. Manage Issues

When to use: User wants to create, update, list, or comment on repository issues

Tool sequence:

1. BITBUCKET_LIST_ISSUES - List issues with optional filters for state, priority, kind, assignee [Required]
2. BITBUCKET_CREATE_ISSUE - Create a new issue with title, content, priority, and kind [Required]
3. BITBUCKET_UPDATE_ISSUE - Modify issue attributes (state, priority, assignee, etc.) [Optional]
4. BITBUCKET_CREATE_ISSUE_COMMENT - Add a markdown comment to an existing issue [Optional]
5. BITBUCKET_DELETE_ISSUE - Permanently delete an issue [Optional]

Key parameters:

• issue_id: String identifier for the issue
• title, content: Required for creation
• kind: bug, enhancement, proposal, or task
• priority: trivial, minor, major, critical, or blocker
• state: new, open, resolved, on hold, invalid, duplicate, wontfix, closed
• assignee: Bitbucket username for CREATE; assignee_account_id (UUID) for UPDATE
• due_on: ISO 8601 format date string

Pitfalls:

• Issue tracker must be enabled on the repository (has_issues: true) or API calls will fail
• CREATE_ISSUE uses assignee (username string), but UPDATE_ISSUE uses assignee_account_id (UUID) -- they are different fields
• DELETE_ISSUE is permanent with no undo
• state values include spaces: "on hold" not "on_hold"
• Filtering by assignee in LIST_ISSUES uses account ID, not username; use "null" string for unassigned

4. Manage Branches

When to use: User wants to create branches or explore branch structure

Tool sequence:

1. BITBUCKET_LIST_BRANCHES - List branches with optional BBQL filter and sorting [Required]
2. BITBUCKET_CREATE_BRANCH - Create a new branch from a specific commit hash [Required]

Key parameters:

• name: Branch name without refs/heads/ prefix (e.g., feature/new-login)
• target_hash: Full SHA1 commit hash to branch from (must exist in repo)
• q: BBQL filter (e.g., name~"feature/", name="main")
• sort: Sort by name or -target.date (descending commit date)
• pagelen: 1-100 results per page (default is 10)

Pitfalls:

• CREATE_BRANCH requires a full commit hash, NOT a branch name as target_hash
• Do NOT include refs/heads/ prefix in branch names
• Branch names must follow Bitbucket naming conventions (alphanumeric, /, ., _, -)
• BBQL string values need double quotes: name~"feature/" not name~feature/

5. Review Pull Requests with Comments

When to use: User wants to add review comments to pull requests, including inline code comments

Tool sequence:

1. BITBUCKET_GET_PULL_REQUEST - Get PR details and verify it exists [Prerequisite]
2. BITBUCKET_GET_PULL_REQUEST_DIFF - Review the actual code changes [Prerequisite]
3. BITBUCKET_GET_PULL_REQUEST_DIFFSTAT - Get list of changed files [Optional]
4. BITBUCKET_CREATE_PULL_REQUEST_COMMENT - Post review comments [Required]

Key parameters:

• pull_request_id: String ID of the PR
• content_raw: Markdown-formatted comment text
• content_markup: Defaults to markdown; also supports plaintext
• inline: Object with path, from, to for inline code comments
• parent_comment_id: Integer ID for threaded replies to existing comments

Pitfalls:

• pull_request_id is a string in CREATE_PULL_REQUEST_COMMENT but an integer in GET_PULL_REQUEST
• Inline comments require inline.path at minimum; from/to are optional line numbers
• parent_comment_id creates a threaded reply; omit for top-level comments
• Line numbers in inline comments reference the diff, not the source file

Common Patterns

ID Resolution

Always resolve human-readable names to IDs before operations:

• Workspace: BITBUCKET_LIST_WORKSPACES to get workspace slugs
• Repository: BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE with q filter to find repo slugs
• Branch: BITBUCKET_LIST_BRANCHES to verify branch existence before PR creation
• Members: BITBUCKET_LIST_WORKSPACE_MEMBERS to get UUIDs for reviewer assignment

Pagination

Bitbucket uses page-based pagination (not cursor-based):

• Use page (starts at 1) and pagelen (items per page) parameters
• Default page size is typically 10; set pagelen explicitly (max 50 for PRs, 100 for others)
• Check response for next URL or total count to determine if more pages exist
• Always iterate through all pages for complete results

BBQL Filtering

Bitbucket Query Language is available on list endpoints:

• String values MUST use double quotes: name~"pattern"
• Operators: = (exact), ~ (contains), != (not equal), >, >=, <, <=
• Combine with AND / OR: name~"api" AND is_private=true

Known Pitfalls

ID Formats

• Workspace: slug string (e.g., my-workspace) or UUID in braces ({uuid})
• Reviewer UUIDs must include curly braces: {123e4567-e89b-12d3-a456-426614174000}
• Issue IDs are strings; PR IDs are integers in some tools, strings in others
• Commit hashes must be full SHA1 (40 characters)

Parameter Quirks

• assignee vs assignee_account_id: CREATE_ISSUE uses username, UPDATE_ISSUE uses UUID
• state values for issues include spaces: "on hold", not "on_hold"
• destination_branch omission defaults to repo main branch, not main literally
• BBQL repository is not a valid field -- use name

Rate Limits

• Bitbucket Cloud API has rate limits; large batch operations should include delays
• Paginated requests count against rate limits; minimize unnecessary page fetches

Destructive Operations

• BITBUCKET_DELETE_REPOSITORY is irreversible and does not remove forks
• BITBUCKET_DELETE_ISSUE is permanent with no recovery option
• Always confirm with the user before executing delete operations

Quick Reference

Powered by Composio

Box Automation via Rube MCP

Automate Box operations including file upload/download, content search, folder management, collaboration, metadata queries, and sign requests through Composio's Box toolkit.

Toolkit docs: composio.dev/toolkits/box

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Box connection via RUBE_MANAGE_CONNECTIONS with toolkit box
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit box
3. If connection is not ACTIVE, follow the returned auth link to complete Box OAuth
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Upload and Download Files

When to use: User wants to upload files to Box or download files from it

Tool sequence:

1. BOX_SEARCH_FOR_CONTENT - Find the target folder if path is unknown [Prerequisite]
2. BOX_GET_FOLDER_INFORMATION - Verify folder exists and get folder_id [Prerequisite]
3. BOX_LIST_ITEMS_IN_FOLDER - Browse folder contents and discover file IDs [Optional]
4. BOX_UPLOAD_FILE - Upload a file to a specific folder [Required for upload]
5. BOX_DOWNLOAD_FILE - Download a file by file_id [Required for download]
6. BOX_CREATE_ZIP_DOWNLOAD - Bundle multiple files/folders into a zip [Optional]

Key parameters:

• parent_id: Folder ID for upload destination (use "0" for root folder)
• file: FileUploadable object with s3key, mimetype, and name for uploads
• file_id: Unique file identifier for downloads
• version: Optional file version ID for downloading specific versions
• fields: Comma-separated list of attributes to return

Pitfalls:

• Uploading to a folder with existing filenames can trigger conflict behavior; decide overwrite vs rename semantics
• Files over 50MB should use chunk upload APIs (not available via standard tools)
• The attributes part of upload must come before the file part or you get HTTP 400 with metadata_after_file_contents
• File IDs and folder IDs are numeric strings extractable from Box web app URLs (e.g., https://*.app.box.com/files/123 gives file_id "123")

2. Search and Browse Content

When to use: User wants to find files, folders, or web links by name, content, or metadata

Tool sequence:

1. BOX_SEARCH_FOR_CONTENT - Full-text search across files, folders, and web links [Required]
2. BOX_LIST_ITEMS_IN_FOLDER - Browse contents of a specific folder [Optional]
3. BOX_GET_FILE_INFORMATION - Get detailed metadata for a specific file [Optional]
4. BOX_GET_FOLDER_INFORMATION - Get detailed metadata for a specific folder [Optional]
5. BOX_QUERY_FILES_FOLDERS_BY_METADATA - Search by metadata template values [Optional]
6. BOX_LIST_RECENTLY_ACCESSED_ITEMS - List recently accessed items [Optional]

Key parameters:

• query: Search string supporting operators ("" exact match, AND, OR, NOT - uppercase only)
• type: Filter by "file", "folder", or "web_link"
• ancestor_folder_ids: Limit search to specific folders (comma-separated IDs)
• file_extensions: Filter by file type (comma-separated, no dots)
• content_types: Search in "name", "description", "file_content", "comments", "tags"
• created_at_range / updated_at_range: Date filters as comma-separated RFC3339 timestamps
• limit: Results per page (default 30)
• offset: Pagination offset (max 10000)
• folder_id: For LIST_ITEMS_IN_FOLDER (use "0" for root)

Pitfalls:

• Queries with offset > 10000 are rejected with HTTP 400
• BOX_SEARCH_FOR_CONTENT requires either query or mdfilters parameter
• Misconfigured filters can silently omit expected items; validate with small test queries first
• Boolean operators (AND, OR, NOT) must be uppercase
• BOX_LIST_ITEMS_IN_FOLDER requires pagination via marker or offset/usemarker; partial listings are common
• Standard folders sort items by type first (folders before files before web links)

3. Manage Folders

When to use: User wants to create, update, move, copy, or delete folders

Tool sequence:

1. BOX_GET_FOLDER_INFORMATION - Verify folder exists and check permissions [Prerequisite]
2. BOX_CREATE_FOLDER - Create a new folder [Required for create]
3. BOX_UPDATE_FOLDER - Rename, move, or update folder settings [Required for update]
4. BOX_COPY_FOLDER - Copy a folder to a new location [Optional]
5. BOX_DELETE_FOLDER - Move folder to trash [Required for delete]
6. BOX_PERMANENTLY_REMOVE_FOLDER - Permanently delete a trashed folder [Optional]

Key parameters:

• name: Folder name (no /, \, trailing spaces, or ./..)
• parent__id: Parent folder ID (use "0" for root)
• folder_id: Target folder ID for operations
• parent.id: Destination folder ID for moves via BOX_UPDATE_FOLDER
• recursive: Set true to delete non-empty folders
• shared_link: Object with access, password, permissions for creating shared links on folders
• description, tags: Optional metadata fields

Pitfalls:

• BOX_DELETE_FOLDER moves to trash by default; use BOX_PERMANENTLY_REMOVE_FOLDER for permanent deletion
• Non-empty folders require recursive: true for deletion
• Root folder (ID "0") cannot be copied or deleted
• Folder names cannot contain /, \, non-printable ASCII, or trailing spaces
• Moving folders requires setting parent.id via BOX_UPDATE_FOLDER

4. Share Files and Manage Collaborations

When to use: User wants to share files, manage access, or handle collaborations

Tool sequence:

1. BOX_GET_FILE_INFORMATION - Get file details and current sharing status [Prerequisite]
2. BOX_LIST_FILE_COLLABORATIONS - List who has access to a file [Required]
3. BOX_UPDATE_COLLABORATION - Change access level or accept/reject invitations [Required]
4. BOX_GET_COLLABORATION - Get details of a specific collaboration [Optional]
5. BOX_UPDATE_FILE - Create shared links, lock files, or update permissions [Optional]
6. BOX_UPDATE_FOLDER - Create shared links on folders [Optional]

Key parameters:

• collaboration_id: Unique collaboration identifier
• role: Access level ("editor", "viewer", "co-owner", "owner", "previewer", "uploader", "viewer uploader", "previewer uploader")
• status: "accepted", "pending", or "rejected" for collaboration invites
• file_id: File to share or manage
• lock__access: Set to "lock" to lock a file
• permissions__can__download: "company" or "open" for download permissions

Pitfalls:

• Only certain roles can invite collaborators; insufficient permissions cause authorization errors
• can_view_path increases load time for the invitee's "All Files" page; limit to 1000 per user
• Collaboration expiration requires enterprise admin settings to be enabled
• Nested parameter names use double underscores (e.g., lock__access, parent__id)

5. Box Sign Requests

When to use: User wants to manage document signature requests

Tool sequence:

1. BOX_LIST_BOX_SIGN_REQUESTS - List all signature requests [Required]
2. BOX_GET_BOX_SIGN_REQUEST_BY_ID - Get details of a specific sign request [Optional]
3. BOX_CANCEL_BOX_SIGN_REQUEST - Cancel a pending sign request [Optional]

Key parameters:

• sign_request_id: UUID of the sign request
• shared_requests: Set true to include requests where user is a collaborator (not owner)
• senders: Filter by sender emails (requires shared_requests: true)
• limit / marker: Pagination parameters

Pitfalls:

• Requires Box Sign to be enabled for the enterprise account
• Deleted sign files or parent folders cause requests to not appear in listings
• Only the creator can cancel a sign request
• Sign request statuses include: converting, created, sent, viewed, signed, declined, cancelled, expired, error_converting, error_sending

Common Patterns

ID Resolution

Box uses numeric string IDs for all entities:

• Root folder: Always ID "0"
• File ID from URL: https://*.app.box.com/files/123 gives file_id "123"
• Folder ID from URL: https://*.app.box.com/folder/123 gives folder_id "123"
• Search to ID: Use BOX_SEARCH_FOR_CONTENT to find items, then extract IDs from results
• ETag: Use if_match with file's ETag for safe concurrent delete operations

Pagination

Box supports two pagination methods:

• Offset-based: Use offset + limit (max offset 10000)
• Marker-based: Set usemarker: true and follow marker from responses (preferred for large datasets)
• Always paginate to completion to avoid partial results

Nested Parameters

Box tools use double underscore notation for nested objects:

• parent__id for parent folder reference
• lock__access, lock__expires__at, lock__is__download__prevented for file locks
• permissions__can__download for download permissions

Known Pitfalls

ID Formats

• All IDs are numeric strings (e.g., "123456", not integers)
• Root folder is always "0"
• File and folder IDs can be extracted from Box web app URLs

Rate Limits

• Box API has per-endpoint rate limits
• Search and list operations should use pagination responsibly
• Bulk operations should include delays between requests

Parameter Quirks

• fields parameter changes response shape: when specified, only mini representation + requested fields are returned
• Search requires either query or mdfilters; both are optional individually but one must be present
• BOX_UPDATE_FILE with lock set to null removes the lock (raw API only)
• Metadata query from field format: enterprise_{enterprise_id}.templateKey or global.templateKey

Permissions

• Deletions fail without sufficient permissions; always handle error responses
• Collaboration roles determine what operations are allowed
• Enterprise settings may restrict certain sharing options

Quick Reference

Powered by Composio

Anthropic Brand Styling

Overview

To access Anthropic's official brand identity and style resources, use this skill.

Keywords: branding, corporate identity, visual identity, post-processing, styling, brand colors, typography, Anthropic brand, visual formatting, visual design

Brand Guidelines

Colors

Main Colors:

• Dark: #141413 - Primary text and dark backgrounds
• Light: #faf9f5 - Light backgrounds and text on dark
• Mid Gray: #b0aea5 - Secondary elements
• Light Gray: #e8e6dc - Subtle backgrounds

Accent Colors:

• Orange: #d97757 - Primary accent
• Blue: #6a9bcc - Secondary accent
• Green: #788c5d - Tertiary accent

Typography

• Headings: Poppins (with Arial fallback)
• Body Text: Lora (with Georgia fallback)
• Note: Fonts should be pre-installed in your environment for best results

Features

Smart Font Application

• Applies Poppins font to headings (24pt and larger)
• Applies Lora font to body text
• Automatically falls back to Arial/Georgia if custom fonts unavailable
• Preserves readability across all systems

Text Styling

• Headings (24pt+): Poppins font
• Body text: Lora font
• Smart color selection based on background
• Preserves text hierarchy and formatting

Shape and Accent Colors

• Non-text shapes use accent colors
• Cycles through orange, blue, and green accents
• Maintains visual interest while staying on-brand

Technical Details

Font Management

• Uses system-installed Poppins and Lora fonts when available
• Provides automatic fallback to Arial (headings) and Georgia (body)
• No font installation required - works with existing system fonts
• For best results, pre-install Poppins and Lora fonts in your environment

Color Application

• Uses RGB color values for precise brand matching
• Applied via python-pptx's RGBColor class
• Maintains color fidelity across different systems

Brevo Automation via Rube MCP

Automate Brevo (formerly Sendinblue) email marketing operations through Composio's Brevo toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/brevo

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Brevo connection via RUBE_MANAGE_CONNECTIONS with toolkit brevo
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit brevo
3. If connection is not ACTIVE, follow the returned auth link to complete Brevo authentication
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Manage Email Campaigns

When to use: User wants to list, review, or update email campaigns

Tool sequence:

1. BREVO_LIST_EMAIL_CAMPAIGNS - List all campaigns with filters [Required]
2. BREVO_UPDATE_EMAIL_CAMPAIGN - Update campaign content or settings [Optional]

Key parameters for listing:

• type: Campaign type ('classic' or 'trigger')
• status: Campaign status ('suspended', 'archive', 'sent', 'queued', 'draft', 'inProcess', 'inReview')
• startDate/endDate: Date range filter (YYYY-MM-DDTHH:mm:ss.SSSZ format)
• statistics: Stats type to include ('globalStats', 'linksStats', 'statsByDomain')
• limit: Results per page (max 100, default 50)
• offset: Pagination offset
• sort: Sort order ('asc' or 'desc')
• excludeHtmlContent: Set true to reduce response size

Key parameters for update:

• campaign_id: Numeric campaign ID (required)
• name: Campaign name
• subject: Email subject line
• htmlContent: HTML email body (mutually exclusive with htmlUrl)
• htmlUrl: URL to HTML content
• sender: Sender object with name, email, or id
• recipients: Object with listIds and exclusionListIds
• scheduledAt: Scheduled send time (YYYY-MM-DDTHH:mm:ss.SSSZ)

Pitfalls:

• startDate and endDate are mutually required; provide both or neither
• Date filters only work when status is not passed or set to 'sent'
• htmlContent and htmlUrl are mutually exclusive
• Campaign sender email must be a verified sender in Brevo
• A/B testing fields (subjectA, subjectB, splitRule, winnerCriteria) require abTesting: true
• scheduledAt uses full ISO 8601 format with timezone

2. Create and Manage Email Templates

When to use: User wants to create, edit, list, or delete email templates

Tool sequence:

1. BREVO_GET_ALL_EMAIL_TEMPLATES - List all templates [Required]
2. BREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATE - Create a new template or update existing [Required]
3. BREVO_DELETE_EMAIL_TEMPLATE - Delete an inactive template [Optional]

Key parameters for listing:

• templateStatus: Filter active (true) or inactive (false) templates
• limit: Results per page (max 1000, default 50)
• offset: Pagination offset
• sort: Sort order ('asc' or 'desc')

Key parameters for create/update:

• templateId: Include to update; omit to create new
• templateName: Template display name (required for creation)
• subject: Email subject line (required for creation)
• htmlContent: HTML template body (min 10 characters; use this or htmlUrl)
• sender: Sender object with name and email, or id (required for creation)
• replyTo: Reply-to email address
• isActive: Activate or deactivate the template
• tag: Category tag for the template

Pitfalls:

• When templateId is provided, the tool updates; when omitted, it creates
• For creation, templateName, subject, and sender are required
• htmlContent must be at least 10 characters
• Template personalization uses {{contact.ATTRIBUTE}} syntax
• Only inactive templates can be deleted
• htmlContent and htmlUrl are mutually exclusive

3. Manage Senders

When to use: User wants to view authorized sender identities

Tool sequence:

1. BREVO_GET_ALL_SENDERS - List all verified senders [Required]

Key parameters: (none required)

Pitfalls:

• Senders must be verified before they can be used in campaigns or templates
• Sender verification is done through the Brevo web interface, not via API
• Sender IDs can be used in sender.id fields for campaigns and templates

4. Configure A/B Testing Campaigns

When to use: User wants to set up or modify A/B test settings on a campaign

Tool sequence:

1. BREVO_LIST_EMAIL_CAMPAIGNS - Find the target campaign [Prerequisite]
2. BREVO_UPDATE_EMAIL_CAMPAIGN - Configure A/B test settings [Required]

Key parameters:

• campaign_id: Campaign to configure
• abTesting: Set to true to enable A/B testing
• subjectA: Subject line for variant A
• subjectB: Subject line for variant B
• splitRule: Percentage split for the test (1-99)
• winnerCriteria: 'open' or 'click' for determining the winner
• winnerDelay: Hours to wait before selecting winner (1-168)

Pitfalls:

• A/B testing must be enabled (abTesting: true) before setting variant fields
• splitRule is the percentage of contacts that receive variant A
• winnerDelay defines how long to test before sending the winner to remaining contacts
• Only works with 'classic' campaign type

Common Patterns

Campaign Lifecycle

1. Create campaign (status: draft)
2. Set recipients (listIds)
3. Configure content (htmlContent or htmlUrl)
4. Optionally schedule (scheduledAt)
5. Send or schedule via Brevo UI (API update can set scheduledAt)

Pagination

• Use limit (page size) and offset (starting index)
• Default limit is 50; max varies by endpoint (100 for campaigns, 1000 for templates)
• Increment offset by limit each page
• Check count in response to determine total available

Template Personalization

- First name: {{contact.FIRSTNAME}}
- Last name: {{contact.LASTNAME}}
- Custom attribute: {{contact.CUSTOM_ATTRIBUTE}}
- Mirror link: {{mirror}}
- Unsubscribe link: {{unsubscribe}}

Known Pitfalls

Date Formats:

• All dates use ISO 8601 with milliseconds: YYYY-MM-DDTHH:mm:ss.SSSZ
• Pass timezone in the date-time format for accurate results
• startDate and endDate must be used together

Sender Verification:

• All sender emails must be verified in Brevo before use
• Unverified senders cause campaign creation/update failures
• Use GET_ALL_SENDERS to check available verified senders

Rate Limits:

• Brevo API has rate limits per account plan
• Implement backoff on 429 responses
• Template operations have lower limits than read operations

Response Parsing:

• Response data may be nested under data or data.data
• Parse defensively with fallback patterns
• Campaign and template IDs are numeric integers

Quick Reference

Powered by Composio

Cal.com Automation via Rube MCP

Automate Cal.com scheduling operations through Composio's Cal toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/cal

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Cal.com connection via RUBE_MANAGE_CONNECTIONS with toolkit cal
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit cal
3. If connection is not ACTIVE, follow the returned auth link to complete Cal.com authentication
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Manage Bookings

When to use: User wants to list, create, or review bookings

Tool sequence:

1. CAL_FETCH_ALL_BOOKINGS - List all bookings with filters [Required]
2. CAL_POST_NEW_BOOKING_REQUEST - Create a new booking [Optional]

Key parameters for listing:

• status: Filter by booking status ('upcoming', 'recurring', 'past', 'cancelled', 'unconfirmed')
• afterStart: Filter bookings after this date (ISO 8601)
• beforeEnd: Filter bookings before this date (ISO 8601)

Key parameters for creation:

• eventTypeId: Event type ID for the booking
• start: Booking start time (ISO 8601)
• end: Booking end time (ISO 8601)
• name: Attendee name
• email: Attendee email
• timeZone: Attendee timezone (IANA format)
• language: Attendee language code
• metadata: Additional metadata object

Pitfalls:

• Date filters use ISO 8601 format with timezone (e.g., '2024-01-15T09:00:00Z')
• eventTypeId must reference a valid, active event type
• Booking creation requires matching an available slot; check availability first
• Time zone must be a valid IANA timezone string (e.g., 'America/New_York')
• Status filter values are specific strings; invalid values return empty results

2. Check Availability

When to use: User wants to find free/busy times or available booking slots

Tool sequence:

1. CAL_RETRIEVE_CALENDAR_BUSY_TIMES - Get busy time blocks [Required]
2. CAL_GET_AVAILABLE_SLOTS_INFO - Get specific available slots [Required]

Key parameters:

• dateFrom: Start date for availability check (YYYY-MM-DD)
• dateTo: End date for availability check (YYYY-MM-DD)
• eventTypeId: Event type to check slots for
• timeZone: Timezone for the availability response
• loggedInUsersTz: Timezone of the requesting user

Pitfalls:

• Busy times show when the user is NOT available
• Available slots are specific to an event type's duration and configuration
• Date range should be reasonable (not months in advance) to get accurate results
• Timezone affects how slots are displayed; always specify explicitly
• Availability reflects calendar integrations (Google Calendar, Outlook, etc.)

3. Configure Webhooks

When to use: User wants to set up or manage webhook notifications for booking events

Tool sequence:

1. CAL_RETRIEVE_WEBHOOKS_LIST - List existing webhooks [Required]
2. CAL_GET_WEBHOOK_BY_ID - Get specific webhook details [Optional]
3. CAL_UPDATE_WEBHOOK_BY_ID - Update webhook configuration [Optional]
4. CAL_DELETE_WEBHOOK_BY_ID - Remove a webhook [Optional]

Key parameters:

• id: Webhook ID for GET/UPDATE/DELETE operations
• subscriberUrl: Webhook endpoint URL
• eventTriggers: Array of event types to trigger on
• active: Whether the webhook is active
• secret: Webhook signing secret

Pitfalls:

• Webhook URLs must be publicly accessible HTTPS endpoints
• Event triggers include: 'BOOKING_CREATED', 'BOOKING_RESCHEDULED', 'BOOKING_CANCELLED', etc.
• Inactive webhooks do not fire; toggle active to enable/disable
• Webhook secrets are used for payload signature verification

4. Manage Teams

When to use: User wants to create, view, or manage teams and team event types

Tool sequence:

1. CAL_GET_TEAMS_LIST - List all teams [Required]
2. CAL_GET_TEAM_INFORMATION_BY_TEAM_ID - Get specific team details [Optional]
3. CAL_CREATE_TEAM_IN_ORGANIZATION - Create a new team [Optional]
4. CAL_RETRIEVE_TEAM_EVENT_TYPES - List event types for a team [Optional]

Key parameters:

• teamId: Team identifier
• name: Team name (for creation)
• slug: URL-friendly team identifier

Pitfalls:

• Team creation may require organization-level permissions
• Team event types are separate from personal event types
• Team slugs must be URL-safe and unique within the organization

5. Organization Management

When to use: User wants to view organization details

Tool sequence:

1. CAL_GET_ORGANIZATION_ID - Get the organization ID [Required]

Key parameters: (none required)

Pitfalls:

• Organization ID is needed for team creation and org-level operations
• Not all Cal.com accounts have organizations; personal plans may return errors

Common Patterns

Booking Creation Flow

1. Call CAL_GET_AVAILABLE_SLOTS_INFO to find open slots
2. Present available times to the user
3. Call CAL_POST_NEW_BOOKING_REQUEST with selected slot
4. Confirm booking creation response

ID Resolution

Team name -> Team ID:

1. Call CAL_GET_TEAMS_LIST
2. Find team by name in response
3. Extract id field

Webhook Setup

1. Call CAL_RETRIEVE_WEBHOOKS_LIST to check existing hooks
2. Create or update webhook with desired triggers
3. Verify webhook fires on test booking

Known Pitfalls

Date/Time Formats:

• Booking times: ISO 8601 with timezone (e.g., '2024-01-15T09:00:00Z')
• Availability dates: YYYY-MM-DD format
• Always specify timezone explicitly to avoid confusion

Event Types:

• Event type IDs are numeric integers
• Event types define duration, location, and booking rules
• Disabled event types cannot accept new bookings

Permissions:

• Team operations require team membership or admin access
• Organization operations require org-level permissions
• Webhook management requires appropriate access level

Rate Limits:

• Cal.com API has rate limits per API key
• Implement backoff on 429 responses

Quick Reference

Powered by Composio

Calendly Automation via Rube MCP

Automate Calendly operations including event listing, invitee management, scheduling link creation, availability queries, and organization administration through Composio's Calendly toolkit.

Toolkit docs: composio.dev/toolkits/calendly

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Calendly connection via RUBE_MANAGE_CONNECTIONS with toolkit calendly
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas
• Many operations require the user's Calendly URI, obtained via CALENDLY_GET_CURRENT_USER

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit calendly
3. If connection is not ACTIVE, follow the returned auth link to complete Calendly OAuth
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. List and View Scheduled Events

When to use: User wants to see their upcoming, past, or filtered Calendly events

Tool sequence:

1. CALENDLY_GET_CURRENT_USER - Get authenticated user URI and organization URI [Prerequisite]
2. CALENDLY_LIST_EVENTS - List events scoped by user, organization, or group [Required]
3. CALENDLY_GET_EVENT - Get detailed info for a specific event by UUID [Optional]

Key parameters:

• user: Full Calendly API URI (e.g., https://api.calendly.com/users/{uuid}) - NOT "me"
• organization: Full organization URI for org-scoped queries
• status: "active" or "canceled"
• min_start_time / max_start_time: UTC timestamps (e.g., 2024-01-01T00:00:00.000000Z)
• invitee_email: Filter events by invitee email (filter only, not a scope)
• sort: "start_time:asc" or "start_time:desc"
• count: Results per page (default 20)
• page_token: Pagination token from previous response

Pitfalls:

• Exactly ONE of user, organization, or group must be provided - omitting or combining scopes fails
• The user parameter requires the full API URI, not "me" - use CALENDLY_GET_CURRENT_USER first
• invitee_email is a filter, not a scope; you still need one of user/organization/group
• Pagination uses count + page_token; loop until page_token is absent for complete results
• Admin rights may be needed for organization or group scope queries

2. Manage Event Invitees

When to use: User wants to see who is booked for events or get invitee details

Tool sequence:

1. CALENDLY_LIST_EVENTS - Find the target event(s) [Prerequisite]
2. CALENDLY_LIST_EVENT_INVITEES - List all invitees for a specific event [Required]
3. CALENDLY_GET_EVENT_INVITEE - Get detailed info for a single invitee [Optional]

Key parameters:

• uuid: Event UUID (for LIST_EVENT_INVITEES)
• event_uuid + invitee_uuid: Both required for GET_EVENT_INVITEE
• email: Filter invitees by email address
• status: "active" or "canceled"
• sort: "created_at:asc" or "created_at:desc"
• count: Results per page (default 20)

Pitfalls:

• The uuid parameter for CALENDLY_LIST_EVENT_INVITEES is the event UUID, not the invitee UUID
• Paginate using page_token until absent for complete invitee lists
• Canceled invitees are excluded by default; use status: "canceled" to see them

3. Create Scheduling Links and Check Availability

When to use: User wants to generate a booking link or check available time slots

Tool sequence:

1. CALENDLY_GET_CURRENT_USER - Get user URI [Prerequisite]
2. CALENDLY_LIST_USER_S_EVENT_TYPES - List available event types [Required]
3. CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES - Check available slots for an event type [Optional]
4. CALENDLY_CREATE_SCHEDULING_LINK - Generate a single-use scheduling link [Required]
5. CALENDLY_LIST_USER_AVAILABILITY_SCHEDULES - View user's availability schedules [Optional]

Key parameters:

• owner: Event type URI (e.g., https://api.calendly.com/event_types/{uuid})
• owner_type: "EventType" (default)
• max_event_count: Must be exactly 1 for single-use links
• start_time / end_time: UTC timestamps for availability queries (max 7-day range)
• active: Boolean to filter active/inactive event types
• user: User URI for event type listing

Pitfalls:

• CALENDLY_CREATE_SCHEDULING_LINK can return 403 if token lacks rights or owner URI is invalid
• CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES requires UTC timestamps and max 7-day range; split longer searches
• Available times results are NOT paginated - all results returned in one response
• Event type URIs must be full API URIs (e.g., https://api.calendly.com/event_types/...)

4. Cancel Events

When to use: User wants to cancel a scheduled Calendly event

Tool sequence:

1. CALENDLY_LIST_EVENTS - Find the event to cancel [Prerequisite]
2. CALENDLY_GET_EVENT - Confirm event details before cancellation [Prerequisite]
3. CALENDLY_LIST_EVENT_INVITEES - Check who will be affected [Optional]
4. CALENDLY_CANCEL_EVENT - Cancel the event [Required]

Key parameters:

• uuid: Event UUID to cancel
• reason: Optional cancellation reason (may be included in notification to invitees)

Pitfalls:

• Cancellation is IRREVERSIBLE - always confirm with the user before calling
• Cancellation may trigger notifications to invitees
• Only active events can be canceled; already-canceled events return errors
• Get explicit user confirmation before executing CALENDLY_CANCEL_EVENT

5. Manage Organization and Invitations

When to use: User wants to invite members, manage organization, or handle org invitations

Tool sequence:

1. CALENDLY_GET_CURRENT_USER - Get user and organization context [Prerequisite]
2. CALENDLY_GET_ORGANIZATION - Get organization details [Optional]
3. CALENDLY_LIST_ORGANIZATION_INVITATIONS - Check existing invitations [Optional]
4. CALENDLY_CREATE_ORGANIZATION_INVITATION - Send an org invitation [Required]
5. CALENDLY_REVOKE_USER_S_ORGANIZATION_INVITATION - Revoke a pending invitation [Optional]
6. CALENDLY_REMOVE_USER_FROM_ORGANIZATION - Remove a member [Optional]

Key parameters:

• uuid: Organization UUID
• email: Email address of user to invite
• status: Filter invitations by "pending", "accepted", or "declined"

Pitfalls:

• Only org owners/admins can manage invitations and removals; others get authorization errors
• Duplicate active invitations for the same email are rejected - check existing invitations first
• Organization owners cannot be removed via CALENDLY_REMOVE_USER_FROM_ORGANIZATION
• Invitation statuses include pending, accepted, declined, and revoked - handle each appropriately

Common Patterns

ID Resolution

Calendly uses full API URIs as identifiers, not simple IDs:

• Current user URI: CALENDLY_GET_CURRENT_USER returns resource.uri (e.g., https://api.calendly.com/users/{uuid})
• Organization URI: Found in current user response at resource.current_organization
• Event UUID: Extract from event URI or list responses
• Event type URI: From CALENDLY_LIST_USER_S_EVENT_TYPES response

Important: Never use "me" as a user parameter in list/filter endpoints. Always resolve to the full URI first.

Pagination

Most Calendly list endpoints use token-based pagination:

• Set count for page size (default 20)
• Follow page_token from pagination.next_page_token until absent
• Sort with field:direction format (e.g., start_time:asc, created_at:desc)

Time Handling

• All timestamps must be in UTC format: yyyy-MM-ddTHH:mm:ss.ffffffZ
• Use min_start_time / max_start_time for date range filtering on events
• Available times queries have a maximum 7-day range; split longer searches into multiple calls

Known Pitfalls

URI Formats

• All entity references use full Calendly API URIs (e.g., https://api.calendly.com/users/{uuid})
• Never pass bare UUIDs where URIs are expected, and never pass "me" to list endpoints
• Extract UUIDs from URIs when tools expect UUID parameters (e.g., CALENDLY_GET_EVENT)

Scope Requirements

• CALENDLY_LIST_EVENTS requires exactly one scope (user, organization, or group) - no more, no less
• Organization/group scoped queries may require admin privileges
• Token scope determines which operations are available; 403 errors indicate insufficient permissions

Data Relationships

• Events have invitees (attendees who booked)
• Event types define scheduling pages (duration, availability rules)
• Organizations contain users and groups
• Scheduling links are tied to event types, not directly to events

Rate Limits

• Calendly API has rate limits; avoid tight loops over large datasets
• Paginate responsibly and add delays for batch operations

Quick Reference

Powered by Composio

Canva Automation via Rube MCP

Automate Canva design operations through Composio's Canva toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/canva

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Canva connection via RUBE_MANAGE_CONNECTIONS with toolkit canva
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit canva
3. If connection is not ACTIVE, follow the returned auth link to complete Canva OAuth
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. List and Browse Designs

When to use: User wants to find existing designs or browse their Canva library

Tool sequence:

1. CANVA_LIST_USER_DESIGNS - List all designs with optional filters [Required]

Key parameters:

• query: Search term to filter designs by name
• continuation: Pagination token from previous response
• ownership: Filter by 'owned', 'shared', or 'any'
• sort_by: Sort field (e.g., 'modified_at', 'title')

Pitfalls:

• Results are paginated; follow continuation token until absent
• Deleted designs may still appear briefly; check design status
• Search is substring-based, not fuzzy matching

2. Create and Design

When to use: User wants to create a new Canva design from scratch or from a template

Tool sequence:

1. CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST - Browse available brand templates [Optional]
2. CANVA_CREATE_CANVA_DESIGN_WITH_OPTIONAL_ASSET - Create a new design [Required]

Key parameters:

• design_type: Type of design (e.g., 'Presentation', 'Poster', 'SocialMedia')
• title: Name for the new design
• asset_id: Optional asset to include in the design
• width / height: Custom dimensions in pixels

Pitfalls:

• Design type must match Canva's predefined types exactly
• Custom dimensions have minimum and maximum limits
• Asset must be uploaded first via CANVA_CREATE_ASSET_UPLOAD_JOB before referencing

3. Upload Assets

When to use: User wants to upload images or files to Canva for use in designs

Tool sequence:

1. CANVA_CREATE_ASSET_UPLOAD_JOB - Initiate the asset upload [Required]
2. CANVA_FETCH_ASSET_UPLOAD_JOB_STATUS - Poll until upload completes [Required]

Key parameters:

• name: Display name for the asset
• url: Public URL of the file to upload (for URL-based uploads)
• job_id: Upload job ID returned from step 1 (for status polling)

Pitfalls:

• Upload is asynchronous; you MUST poll the job status until it completes
• Supported formats include PNG, JPG, SVG, MP4, GIF
• File size limits apply; large files may take longer to process
• The job_id from CREATE returns the ID needed for status polling
• Status values: 'in_progress', 'success', 'failed'

4. Export Designs

When to use: User wants to download or export a Canva design as PDF, PNG, or other format

Tool sequence:

1. CANVA_LIST_USER_DESIGNS - Find the design to export [Prerequisite]
2. CANVA_CREATE_CANVA_DESIGN_EXPORT_JOB - Start the export process [Required]
3. CANVA_GET_DESIGN_EXPORT_JOB_RESULT - Poll until export completes and get download URL [Required]

Key parameters:

• design_id: ID of the design to export
• format: Export format ('pdf', 'png', 'jpg', 'svg', 'mp4', 'gif', 'pptx')
• pages: Specific page numbers to export (array)
• quality: Export quality ('regular', 'high')
• job_id: Export job ID for polling status

Pitfalls:

• Export is asynchronous; you MUST poll the job result until it completes
• Download URLs from completed exports expire after a limited time
• Large designs with many pages take longer to export
• Not all formats support all design types (e.g., MP4 only for animations)
• Poll interval: wait 2-3 seconds between status checks

5. Organize with Folders

When to use: User wants to create folders or organize designs into folders

Tool sequence:

1. CANVA_POST_FOLDERS - Create a new folder [Required]
2. CANVA_MOVE_ITEM_TO_SPECIFIED_FOLDER - Move designs into folders [Optional]

Key parameters:

• name: Folder name
• parent_folder_id: Parent folder for nested organization
• item_id: ID of the design or asset to move
• folder_id: Target folder ID

Pitfalls:

• Folder names must be unique within the same parent folder
• Moving items between folders updates their location immediately
• Root-level folders have no parent_folder_id

6. Autofill from Brand Templates

When to use: User wants to generate designs by filling brand template placeholders with data

Tool sequence:

1. CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST - List available brand templates [Required]
2. CANVA_INITIATE_CANVA_DESIGN_AUTOFILL_JOB - Start autofill with data [Required]

Key parameters:

• brand_template_id: ID of the brand template to use
• title: Title for the generated design
• data: Key-value mapping of placeholder names to replacement values

Pitfalls:

• Template placeholders must match exactly (case-sensitive)
• Autofill is asynchronous; poll for completion
• Only brand templates support autofill, not regular designs
• Data values must match the expected type for each placeholder (text, image URL)

Common Patterns

Async Job Pattern

Many Canva operations are asynchronous:

1. Initiate job (upload, export, autofill) -> get job_id
2. Poll status endpoint with job_id every 2-3 seconds
3. Check for 'success' or 'failed' status
4. On success, extract result (asset_id, download_url, design_id)

ID Resolution

Design name -> Design ID:

1. Call CANVA_LIST_USER_DESIGNS with query=design_name
2. Find matching design in results
3. Extract id field

Brand template name -> Template ID:

1. Call CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST
2. Find template by name
3. Extract brand_template_id

Pagination

• Check response for continuation token
• Pass token in next request's continuation parameter
• Continue until continuation is absent or empty

Known Pitfalls

Async Operations:

• Uploads, exports, and autofills are all asynchronous
• Always poll job status; do not assume immediate completion
• Download URLs from exports expire; use them promptly

Asset Management:

• Assets must be uploaded before they can be used in designs
• Upload job must reach 'success' status before the asset_id is valid
• Supported formats vary; check Canva documentation for current limits

Rate Limits:

• Canva API has rate limits per endpoint
• Implement exponential backoff for bulk operations
• Batch operations where possible to reduce API calls

Response Parsing:

• Response data may be nested under data key
• Job status responses include different fields based on completion state
• Parse defensively with fallbacks for optional fields

Quick Reference

Powered by Composio

These are instructions for creating design philosophies - aesthetic movements that are then EXPRESSED VISUALLY. Output only .md files, .pdf files, and .png files.

Complete this in two steps:

1. Design Philosophy Creation (.md file)
2. Express by creating it on a canvas (.pdf file or .png file)

First, undertake this task:

DESIGN PHILOSOPHY CREATION

To begin, create a VISUAL PHILOSOPHY (not layouts or templates) that will be interpreted through:

• Form, space, color, composition
• Images, graphics, shapes, patterns
• Minimal text as visual accent

THE CRITICAL UNDERSTANDING

• What is received: Some subtle input or instructions by the user that should be taken into account, but used as a foundation; it should not constrain creative freedom.
• What is created: A design philosophy/aesthetic movement.
• What happens next: Then, the same version receives the philosophy and EXPRESSES IT VISUALLY - creating artifacts that are 90% visual design, 10% essential text.

Consider this approach:

• Write a manifesto for an art movement
• The next phase involves making the artwork

The philosophy must emphasize: Visual expression. Spatial communication. Artistic interpretation. Minimal words.

HOW TO GENERATE A VISUAL PHILOSOPHY

Name the movement (1-2 words): "Brutalist Joy" / "Chromatic Silence" / "Metabolist Dreams"

Articulate the philosophy (4-6 paragraphs - concise but complete):

To capture the VISUAL essence, express how the philosophy manifests through:

• Space and form
• Color and material
• Scale and rhythm
• Composition and balance
• Visual hierarchy

CRITICAL GUIDELINES:

• Avoid redundancy: Each design aspect should be mentioned once. Avoid repeating points about color theory, spatial relationships, or typographic principles unless adding new depth.
• Emphasize craftsmanship REPEATEDLY: The philosophy MUST stress multiple times that the final work should appear as though it took countless hours to create, was labored over with care, and comes from someone at the absolute top of their field. This framing is essential - repeat phrases like "meticulously crafted," "the product of deep expertise," "painstaking attention," "master-level execution."
• Leave creative space: Remain specific about the aesthetic direction, but concise enough that the next Claude has room to make interpretive choices also at a extremely high level of craftmanship.

The philosophy must guide the next version to express ideas VISUALLY, not through text. Information lives in design, not paragraphs.

PHILOSOPHY EXAMPLES

"Concrete Poetry" Philosophy: Communication through monumental form and bold geometry. Visual expression: Massive color blocks, sculptural typography (huge single words, tiny labels), Brutalist spatial divisions, Polish poster energy meets Le Corbusier. Ideas expressed through visual weight and spatial tension, not explanation. Text as rare, powerful gesture - never paragraphs, only essential words integrated into the visual architecture. Every element placed with the precision of a master craftsman.

"Chromatic Language" Philosophy: Color as the primary information system. Visual expression: Geometric precision where color zones create meaning. Typography minimal - small sans-serif labels letting chromatic fields communicate. Think Josef Albers' interaction meets data visualization. Information encoded spatially and chromatically. Words only to anchor what color already shows. The result of painstaking chromatic calibration.

"Analog Meditation" Philosophy: Quiet visual contemplation through texture and breathing room. Visual expression: Paper grain, ink bleeds, vast negative space. Photography and illustration dominate. Typography whispered (small, restrained, serving the visual). Japanese photobook aesthetic. Images breathe across pages. Text appears sparingly - short phrases, never explanatory blocks. Each composition balanced with the care of a meditation practice.

"Organic Systems" Philosophy: Natural clustering and modular growth patterns. Visual expression: Rounded forms, organic arrangements, color from nature through architecture. Information shown through visual diagrams, spatial relationships, iconography. Text only for key labels floating in space. The composition tells the story through expert spatial orchestration.

"Geometric Silence" Philosophy: Pure order and restraint. Visual expression: Grid-based precision, bold photography or stark graphics, dramatic negative space. Typography precise but minimal - small essential text, large quiet zones. Swiss formalism meets Brutalist material honesty. Structure communicates, not words. Every alignment the work of countless refinements.

These are condensed examples. The actual design philosophy should be 4-6 substantial paragraphs.

ESSENTIAL PRINCIPLES

• VISUAL PHILOSOPHY: Create an aesthetic worldview to be expressed through design
• MINIMAL TEXT: Always emphasize that text is sparse, essential-only, integrated as visual element - never lengthy
• SPATIAL EXPRESSION: Ideas communicate through space, form, color, composition - not paragraphs
• ARTISTIC FREEDOM: The next Claude interprets the philosophy visually - provide creative room
• PURE DESIGN: This is about making ART OBJECTS, not documents with decoration
• EXPERT CRAFTSMANSHIP: Repeatedly emphasize the final work must look meticulously crafted, labored over with care, the product of countless hours by someone at the top of their field

The design philosophy should be 4-6 paragraphs long. Fill it with poetic design philosophy that brings together the core vision. Avoid repeating the same points. Keep the design philosophy generic without mentioning the intention of the art, as if it can be used wherever. Output the design philosophy as a .md file.

DEDUCING THE SUBTLE REFERENCE

CRITICAL STEP: Before creating the canvas, identify the subtle conceptual thread from the original request.

THE ESSENTIAL PRINCIPLE: The topic is a subtle, niche reference embedded within the art itself - not always literal, always sophisticated. Someone familiar with the subject should feel it intuitively, while others simply experience a masterful abstract composition. The design philosophy provides the aesthetic language. The deduced topic provides the soul - the quiet conceptual DNA woven invisibly into form, color, and composition.

This is VERY IMPORTANT: The reference must be refined so it enhances the work's depth without announcing itself. Think like a jazz musician quoting another song - only those who know will catch it, but everyone appreciates the music.

CANVAS CREATION

With both the philosophy and the conceptual framework established, express it on a canvas. Take a moment to gather thoughts and clear the mind. Use the design philosophy created and the instructions below to craft a masterpiece, embodying all aspects of the philosophy with expert craftsmanship.

IMPORTANT: For any type of content, even if the user requests something for a movie/game/book, the approach should still be sophisticated. Never lose sight of the idea that this should be art, not something that's cartoony or amateur.

To create museum or magazine quality work, use the design philosophy as the foundation. Create one single page, highly visual, design-forward PDF or PNG output (unless asked for more pages). Generally use repeating patterns and perfect shapes. Treat the abstract philosophical design as if it were a scientific bible, borrowing the visual language of systematic observation—dense accumulation of marks, repeated elements, or layered patterns that build meaning through patient repetition and reward sustained viewing. Add sparse, clinical typography and systematic reference markers that suggest this could be a diagram from an imaginary discipline, treating the invisible subject with the same reverence typically reserved for documenting observable phenomena. Anchor the piece with simple phrase(s) or details positioned subtly, using a limited color palette that feels intentional and cohesive. Embrace the paradox of using analytical visual language to express ideas about human experience: the result should feel like an artifact that proves something ephemeral can be studied, mapped, and understood through careful attention. This is true art.

Text as a contextual element: Text is always minimal and visual-first, but let context guide whether that means whisper-quiet labels or bold typographic gestures. A punk venue poster might have larger, more aggressive type than a minimalist ceramics studio identity. Most of the time, font should be thin. All use of fonts must be design-forward and prioritize visual communication. Regardless of text scale, nothing falls off the page and nothing overlaps. Every element must be contained within the canvas boundaries with proper margins. Check carefully that all text, graphics, and visual elements have breathing room and clear separation. This is non-negotiable for professional execution. IMPORTANT: Use different fonts if writing text. Search the ./canvas-fonts directory. Regardless of approach, sophistication is non-negotiable.

Download and use whatever fonts are needed to make this a reality. Get creative by making the typography actually part of the art itself -- if the art is abstract, bring the font onto the canvas, not typeset digitally.

To push boundaries, follow design instinct/intuition while using the philosophy as a guiding principle. Embrace ultimate design freedom and choice. Push aesthetics and design to the frontier.

CRITICAL: To achieve human-crafted quality (not AI-generated), create work that looks like it took countless hours. Make it appear as though someone at the absolute top of their field labored over every detail with painstaking care. Ensure the composition, spacing, color choices, typography - everything screams expert-level craftsmanship. Double-check that nothing overlaps, formatting is flawless, every detail perfect. Create something that could be shown to people to prove expertise and rank as undeniably impressive.

Output the final result as a single, downloadable .pdf or .png file, alongside the design philosophy used as a .md file.

FINAL STEP

IMPORTANT: The user ALREADY said "It isn't perfect enough. It must be pristine, a masterpiece if craftsmanship, as if it were about to be displayed in a museum."

CRITICAL: To refine the work, avoid adding more graphics; instead refine what has been created and make it extremely crisp, respecting the design philosophy and the principles of minimalism entirely. Rather than adding a fun filter or refactoring a font, consider how to make the existing composition more cohesive with the art. If the instinct is to call a new function or draw a new shape, STOP and instead ask: "How can I make what's already here more of a piece of art?"

Take a second pass. Go back to the code and refine/polish further to make this a philosophically designed masterpiece.

MULTI-PAGE OPTION

To create additional pages when requested, create more creative pages along the same lines as the design philosophy but distinctly different as well. Bundle those pages in the same .pdf or many .pngs. Treat the first page as just a single page in a whole coffee table book waiting to be filled. Make the next pages unique twists and memories of the original. Have them almost tell a story in a very tasteful way. Exercise full creative freedom.

Changelog Generator

This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.

When to Use This Skill

• Preparing release notes for a new version
• Creating weekly or monthly product update summaries
• Documenting changes for customers
• Writing changelog entries for app store submissions
• Generating update notifications
• Creating internal release documentation
• Maintaining a public changelog/product updates page

What This Skill Does

1. Scans Git History: Analyzes commits from a specific time period or between versions
2. Categorizes Changes: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
3. Translates Technical → User-Friendly: Converts developer commits into customer language
4. Formats Professionally: Creates clean, structured changelog entries
5. Filters Noise: Excludes internal commits (refactoring, tests, etc.)
6. Follows Best Practices: Applies changelog guidelines and your brand voice

How to Use

Basic Usage

From your project repository:

Create a changelog from commits since last release

Generate changelog for all commits from the past week

Create release notes for version 2.5.0

With Specific Date Range

Create a changelog for all commits between March 1 and March 15

With Custom Guidelines

Create a changelog for commits since v2.4.0, using my changelog 
guidelines from CHANGELOG_STYLE.md

Example

User: "Create a changelog for commits from the past 7 days"

Output:

# Updates - Week of March 10, 2024

## ✨ New Features

- **Team Workspaces**: Create separate workspaces for different 
  projects. Invite team members and keep everything organized.

- **Keyboard Shortcuts**: Press ? to see all available shortcuts. 
  Navigate faster without touching your mouse.

## 🔧 Improvements

- **Faster Sync**: Files now sync 2x faster across devices
- **Better Search**: Search now includes file contents, not just titles

## 🐛 Fixes

- Fixed issue where large images wouldn't upload
- Resolved timezone confusion in scheduled posts
- Corrected notification badge count

Inspired by: Manik Aggarwal's use case from Lenny's Newsletter

Tips

• Run from your git repository root
• Specify date ranges for focused changelogs
• Use your CHANGELOG_STYLE.md for consistent formatting
• Review and adjust the generated changelog before publishing
• Save output directly to CHANGELOG.md

Related Use Cases

• Creating GitHub release notes
• Writing app store update descriptions
• Generating email updates for users
• Creating social media announcement posts

CircleCI Automation via Rube MCP

Automate CircleCI CI/CD operations through Composio's CircleCI toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/circleci

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active CircleCI connection via RUBE_MANAGE_CONNECTIONS with toolkit circleci
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit circleci
3. If connection is not ACTIVE, follow the returned auth link to complete CircleCI authentication
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Trigger a Pipeline

When to use: User wants to start a new CI/CD pipeline run

Tool sequence:

1. CIRCLECI_TRIGGER_PIPELINE - Trigger a new pipeline on a project [Required]
2. CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID - Monitor resulting workflows [Optional]

Key parameters:

• project_slug: Project identifier in format gh/org/repo or bb/org/repo
• branch: Git branch to run the pipeline on
• tag: Git tag to run the pipeline on (mutually exclusive with branch)
• parameters: Pipeline parameter key-value pairs

Pitfalls:

• project_slug format is {vcs}/{org}/{repo} (e.g., gh/myorg/myrepo)
• branch and tag are mutually exclusive; providing both causes an error
• Pipeline parameters must match those defined in .circleci/config.yml
• Triggering returns a pipeline ID; workflows start asynchronously

2. Monitor Pipelines and Workflows

When to use: User wants to check the status of pipelines or workflows

Tool sequence:

1. CIRCLECI_LIST_PIPELINES_FOR_PROJECT - List recent pipelines for a project [Required]
2. CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID - List workflows within a pipeline [Required]
3. CIRCLECI_GET_PIPELINE_CONFIG - View the pipeline configuration used [Optional]

Key parameters:

• project_slug: Project identifier in {vcs}/{org}/{repo} format
• pipeline_id: UUID of a specific pipeline
• branch: Filter pipelines by branch name
• page_token: Pagination cursor for next page of results

Pitfalls:

• Pipeline IDs are UUIDs, not numeric IDs
• Workflows inherit the pipeline ID; a single pipeline can have multiple workflows
• Workflow states include: success, running, not_run, failed, error, failing, on_hold, canceled, unauthorized
• page_token is returned in responses for pagination; continue until absent

3. Inspect Job Details

When to use: User wants to drill into a specific job's execution details

Tool sequence:

1. CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID - Find workflow containing the job [Prerequisite]
2. CIRCLECI_GET_JOB_DETAILS - Get detailed job information [Required]

Key parameters:

• project_slug: Project identifier
• job_number: Numeric job number (not UUID)

Pitfalls:

• Job numbers are integers, not UUIDs (unlike pipeline and workflow IDs)
• Job details include executor type, parallelism, start/stop times, and status
• Job statuses: success, running, not_run, failed, retried, timedout, infrastructure_fail, canceled

4. Retrieve Build Artifacts

When to use: User wants to download or list artifacts produced by a job

Tool sequence:

1. CIRCLECI_GET_JOB_DETAILS - Confirm job completed successfully [Prerequisite]
2. CIRCLECI_GET_JOB_ARTIFACTS - List all artifacts from the job [Required]

Key parameters:

• project_slug: Project identifier
• job_number: Numeric job number

Pitfalls:

• Artifacts are only available after job completion
• Each artifact has a path and url for download
• Artifact URLs may require authentication headers to download
• Large artifacts may have download size limits

5. Review Test Results

When to use: User wants to check test outcomes for a specific job

Tool sequence:

1. CIRCLECI_GET_JOB_DETAILS - Verify job ran tests [Prerequisite]
2. CIRCLECI_GET_TEST_METADATA - Retrieve test results and metadata [Required]

Key parameters:

• project_slug: Project identifier
• job_number: Numeric job number

Pitfalls:

• Test metadata requires the job to have uploaded test results (JUnit XML format)
• If no test results were uploaded, the response will be empty
• Test metadata includes classname, name, result, message, and run_time fields
• Failed tests include failure messages in the message field

Common Patterns

Project Slug Format

Format: {vcs_type}/{org_name}/{repo_name}
- GitHub:    gh/myorg/myrepo
- Bitbucket: bb/myorg/myrepo

Pipeline -> Workflow -> Job Hierarchy

1. Call CIRCLECI_LIST_PIPELINES_FOR_PROJECT to get pipeline IDs
2. Call CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID with pipeline_id
3. Extract job numbers from workflow details
4. Call CIRCLECI_GET_JOB_DETAILS with job_number

Pagination

• Check response for next_page_token field
• Pass token as page_token in next request
• Continue until next_page_token is absent or null

Known Pitfalls

ID Formats:

• Pipeline IDs: UUIDs (e.g., 5034460f-c7c4-4c43-9457-de07e2029e7b)
• Workflow IDs: UUIDs
• Job numbers: Integers (e.g., 123)
• Do NOT mix up UUIDs and integers between different endpoints

Project Slugs:

• Must include VCS prefix: gh/ for GitHub, bb/ for Bitbucket
• Organization and repo names are case-sensitive
• Incorrect slug format causes 404 errors

Rate Limits:

• CircleCI API has per-endpoint rate limits
• Implement exponential backoff on 429 responses
• Avoid rapid polling; use reasonable intervals (5-10 seconds)

Quick Reference

Powered by Composio

clawr.ing — Phone Calling Skill

Give your OpenClaw agent the ability to make real outbound phone calls to you. The agent calls you — you don't call the agent. There is no inbound phone number.

Website: clawr.ing ClawHub: clawhub.ai/marcospgp/clawring

When to Use This Skill

• Your agent needs to reach you urgently and chat messages aren't enough
• Morning briefings, daily summaries, or scheduled check-ins
• Price alerts, server monitoring, build notifications — anything time-sensitive
• You want a hands-free way to interact with your agent (walking, driving, gym)

What This Skill Does

1. Agent sends a REST API call to initiate an outbound phone call to you
2. clawr.ing dials your phone number via its telephony infrastructure
3. You answer and have a real voice conversation with your agent
4. Human speech is transcribed to text, sent to the agent, and the agent's text reply is spoken back via TTS
5. Everything the agent can do in chat still works on the phone — web search, setting alerts, running tasks

The agent sees the conversation as a simple text-based API (REST with long-polling). No WebSocket needed on the agent side.

How to Use

Setup

1. Sign up at clawr.ing
2. Copy the setup prompt from your dashboard
3. Paste it into your OpenClaw agent's chat
4. The agent reads the prompt, stores the API key, and gains phone calling capability

That's it. No Twilio account, no API keys to configure, no webhooks to set up.

Basic Usage

Tell your agent when to call you:

Call me when my build finishes.

Call me every morning at 8am with a briefing.

Call me if Bitcoin drops below $50k.

Call me if the server goes down.

When the agent decides to call, it dials your phone, you pick up, and you talk. When you're done, just say bye and it hangs up.

During a Call

• The agent puts you on hold with music while it works on longer tasks (web search, etc.)
• A thinking sound plays while the agent is generating its response
• You can interrupt the agent mid-sentence (barge-in) — it stops and listens
• Everything the agent can do in chat works on the phone

Key Details

• Outbound only: The agent calls you. You cannot call the agent. There is no inbound number.
• Managed service: No Twilio setup, no API keys, no webhooks. Paste one prompt and it works.
• 100+ countries: Call yourself from pretty much anywhere in the world.
• 70+ voices: Choose a voice for your agent from the dashboard.
• Model-agnostic: Works with any LLM that can make HTTP requests (Claude, GPT, Gemini, local models).
• Fast model recommended: Assign the skill to a fast, lightweight model (Haiku-class) for natural conversation pace. Slow models make conversations feel laggy.

Example

User (in OpenClaw chat): "Call me if ETH goes above $4000."

The agent monitors the price. When ETH crosses $4000:

1. Agent calls your phone
2. You answer
3. Agent: "Hey, ETH just crossed $4000. It's currently at $4,012. Want me to do anything?"
4. You: "Yeah, sell half my position."
5. Agent: "On it. Let me check your portfolio..." (hold music plays)
6. Agent comes back with the result
7. You: "Thanks, bye."
8. Call ends.

Tips

• Use a separate fast model for the calling skill so conversations feel natural
• Set up alerts for things that are genuinely urgent — the phone is for things you can't afford to miss
• The agent can call you proactively based on cron schedules, events, or triggers you define in OpenClaw
• You can tell the agent your preferences for when it's okay to call (e.g., "don't call me after 10pm")

ClickUp Automation via Rube MCP

Automate ClickUp project management workflows including task creation and updates, workspace hierarchy navigation, comments, and team member management through Composio's ClickUp toolkit.

Toolkit docs: composio.dev/toolkits/clickup

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active ClickUp connection via RUBE_MANAGE_CONNECTIONS with toolkit clickup
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit clickup
3. If connection is not ACTIVE, follow the returned auth link to complete ClickUp OAuth
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Create and Manage Tasks

When to use: User wants to create tasks, subtasks, update task properties, or list tasks in a ClickUp list.

Tool sequence:

1. CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES - Get workspace/team IDs [Prerequisite]
2. CLICKUP_GET_SPACES - List spaces in the workspace [Prerequisite]
3. CLICKUP_GET_FOLDERS - List folders in a space [Prerequisite]
4. CLICKUP_GET_FOLDERLESS_LISTS - Get lists not inside folders [Optional]
5. CLICKUP_GET_LIST - Validate list and check available statuses [Prerequisite]
6. CLICKUP_CREATE_TASK - Create a task in the target list [Required]
7. CLICKUP_CREATE_TASK (with parent) - Create subtask under a parent task [Optional]
8. CLICKUP_UPDATE_TASK - Modify task status, assignees, dates, priority [Optional]
9. CLICKUP_GET_TASK - Retrieve full task details [Optional]
10. CLICKUP_GET_TASKS - List all tasks in a list with filters [Optional]
11. CLICKUP_DELETE_TASK - Permanently remove a task [Optional]

Key parameters for CLICKUP_CREATE_TASK:

• list_id: Target list ID (integer, required)
• name: Task name (string, required)
• description: Detailed task description
• status: Must exactly match (case-sensitive) a status name configured in the target list
• priority: 1 (Urgent), 2 (High), 3 (Normal), 4 (Low)
• assignees: Array of user IDs (integers)
• due_date: Unix timestamp in milliseconds
• parent: Parent task ID string for creating subtasks
• tags: Array of tag name strings
• time_estimate: Estimated time in milliseconds

Pitfalls:

• status is case-sensitive and must match an existing status in the list; use CLICKUP_GET_LIST to check available statuses
• due_date and start_date are Unix timestamps in milliseconds, not seconds
• Subtask parent must be a task (not another subtask) in the same list
• notify_all triggers watcher notifications; set to false for bulk operations
• Retries can create duplicates; track created task IDs to avoid re-creation
• custom_item_id for milestones (ID 1) is subject to workspace plan quotas

2. Navigate Workspace Hierarchy

When to use: User wants to browse or manage the ClickUp workspace structure (Workspaces > Spaces > Folders > Lists).

Tool sequence:

1. CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES - List all accessible workspaces [Required]
2. CLICKUP_GET_SPACES - List spaces within a workspace [Required]
3. CLICKUP_GET_SPACE - Get details for a specific space [Optional]
4. CLICKUP_GET_FOLDERS - List folders in a space [Required]
5. CLICKUP_GET_FOLDER - Get details for a specific folder [Optional]
6. CLICKUP_CREATE_FOLDER - Create a new folder in a space [Optional]
7. CLICKUP_GET_FOLDERLESS_LISTS - List lists not inside any folder [Required]
8. CLICKUP_GET_LIST - Get list details including statuses and custom fields [Optional]

Key parameters:

• team_id: Workspace ID from GET_AUTHORIZED_TEAMS_WORKSPACES (required for spaces)
• space_id: Space ID (required for folders and folderless lists)
• folder_id: Folder ID (required for GET_FOLDER)
• list_id: List ID (required for GET_LIST)
• archived: Boolean filter for archived/active items

Pitfalls:

• ClickUp hierarchy is: Workspace (Team) > Space > Folder > List > Task
• Lists can exist directly under Spaces (folderless) or inside Folders
• Must use CLICKUP_GET_FOLDERLESS_LISTS to find lists not inside folders; CLICKUP_GET_FOLDERS only returns folders
• team_id in ClickUp API refers to the Workspace ID, not a user group

3. Add Comments to Tasks

When to use: User wants to add comments, review existing comments, or manage comment threads on tasks.

Tool sequence:

1. CLICKUP_GET_TASK - Verify task exists and get task_id [Prerequisite]
2. CLICKUP_CREATE_TASK_COMMENT - Add a new comment to the task [Required]
3. CLICKUP_GET_TASK_COMMENTS - List existing comments on the task [Optional]
4. CLICKUP_UPDATE_COMMENT - Edit comment text, assignee, or resolution status [Optional]

Key parameters for CLICKUP_CREATE_TASK_COMMENT:

• task_id: Task ID string (required)
• comment_text: Comment content with ClickUp formatting support (required)
• assignee: User ID to assign the comment to (required)
• notify_all: true/false for watcher notifications (required)

Key parameters for CLICKUP_GET_TASK_COMMENTS:

• task_id: Task ID string (required)
• start / start_id: Pagination for older comments (max 25 per page)

Pitfalls:

• CLICKUP_CREATE_TASK_COMMENT requires all four fields: task_id, comment_text, assignee, and notify_all
• assignee on a comment assigns the comment (not the task) to that user
• Comments are paginated at 25 per page; use start (Unix ms) and start_id for older pages
• CLICKUP_UPDATE_COMMENT requires all four fields: comment_id, comment_text, assignee, resolved

4. Manage Team Members and Assignments

When to use: User wants to view workspace members, check seat utilization, or look up user details.

Tool sequence:

1. CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES - List workspaces and get team_id [Required]
2. CLICKUP_GET_WORKSPACE_SEATS - Check seat utilization (members vs guests) [Required]
3. CLICKUP_GET_TEAMS - List user groups within the workspace [Optional]
4. CLICKUP_GET_USER - Get details for a specific user (Enterprise only) [Optional]
5. CLICKUP_GET_CUSTOM_ROLES - List custom permission roles [Optional]

Key parameters:

• team_id: Workspace ID (required for all team operations)
• user_id: Specific user ID for GET_USER
• group_ids: Comma-separated group IDs to filter teams

Pitfalls:

• CLICKUP_GET_WORKSPACE_SEATS returns seat counts, not member details; distinguish members from guests
• CLICKUP_GET_TEAMS returns user groups, not workspace members; empty groups does not mean no members
• CLICKUP_GET_USER is only available on ClickUp Enterprise Plan
• Must repeat workspace seat queries for each workspace in multi-workspace setups

5. Filter and Query Tasks

When to use: User wants to find tasks with specific filters (status, assignee, dates, tags, custom fields).

Tool sequence:

1. CLICKUP_GET_TASKS - Filter tasks in a list with multiple criteria [Required]
2. CLICKUP_GET_TASK - Get full details for individual tasks [Optional]

Key parameters for CLICKUP_GET_TASKS:

• list_id: List ID (integer, required)
• statuses: Array of status strings to filter by
• assignees: Array of user ID strings
• tags: Array of tag name strings
• due_date_gt / due_date_lt: Unix timestamp in ms for date range
• include_closed: Boolean to include closed tasks
• subtasks: Boolean to include subtasks
• order_by: "id", "created", "updated", or "due_date"
• page: Page number starting at 0 (max 100 tasks per page)

Pitfalls:

• Only tasks whose home list matches list_id are returned; tasks in sublists are not included
• Date filters use Unix timestamps in milliseconds
• Status strings must match exactly; use URL encoding for spaces (e.g., "to%20do")
• Page numbering starts at 0; each page returns up to 100 tasks
• custom_fields filter accepts an array of JSON strings, not objects

Common Patterns

ID Resolution

Always resolve names to IDs through the hierarchy:

• Workspace name -> team_id: CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES and match by name
• Space name -> space_id: CLICKUP_GET_SPACES with team_id
• Folder name -> folder_id: CLICKUP_GET_FOLDERS with space_id
• List name -> list_id: Navigate folders or use CLICKUP_GET_FOLDERLESS_LISTS
• Task name -> task_id: CLICKUP_GET_TASKS with list_id and match by name

Pagination

• CLICKUP_GET_TASKS: Page-based with page starting at 0, max 100 tasks per page
• CLICKUP_GET_TASK_COMMENTS: Uses start (Unix ms) and start_id for cursor-based paging, max 25 per page
• Continue fetching until response returns fewer items than the page size

Known Pitfalls

ID Formats

• Workspace/Team IDs are large integers
• Space, folder, and list IDs are integers
• Task IDs are alphanumeric strings (e.g., "9hz", "abc123")
• User IDs are integers
• Comment IDs are integers

Rate Limits

• ClickUp enforces rate limits; bulk task creation can trigger 429 responses
• Honor Retry-After header when present
• Set notify_all=false for bulk operations to reduce notification load

Parameter Quirks

• team_id in the API means Workspace ID, not a user group
• status on tasks is case-sensitive and list-specific
• Dates are Unix timestamps in milliseconds (multiply seconds by 1000)
• priority is an integer 1-4 (1=Urgent, 4=Low), not a string
• CLICKUP_CREATE_TASK_COMMENT marks assignee and notify_all as required
• To clear a task description, pass a single space " " to CLICKUP_UPDATE_TASK

Hierarchy Rules

• Subtask parent must not itself be a subtask
• Subtask parent must be in the same list
• Lists can be folderless (directly in a Space) or inside a Folder
• Subitem boards are not supported by CLICKUP_CREATE_TASK

Quick Reference

Powered by Composio

Close CRM Automation via Rube MCP

Automate Close CRM operations through Composio's Close toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/close

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Close connection via RUBE_MANAGE_CONNECTIONS with toolkit close
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit close
3. If connection is not ACTIVE, follow the returned auth link to complete Close API authentication
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Create and Manage Leads

When to use: User wants to create new leads or manage existing lead records

Tool sequence:

1. CLOSE_CREATE_LEAD - Create a new lead in Close [Required]

Key parameters:

• name: Lead/company name
• contacts: Array of contact objects associated with the lead
• custom: Custom field values as key-value pairs
• status_id: Lead status ID

Pitfalls:

• Leads in Close represent companies/organizations, not individual people
• Contacts are nested within leads; create the lead first, then contacts are included
• Custom field keys use the custom field ID (e.g., 'custom.cf_XXX'), not display names
• Duplicate lead detection is not automatic; check before creating

2. Log Calls

When to use: User wants to log a phone call activity against a lead

Tool sequence:

1. CLOSE_CREATE_CALL - Log a call activity [Required]

Key parameters:

• lead_id: ID of the associated lead
• contact_id: ID of the contact called
• direction: 'outbound' or 'inbound'
• status: Call status ('completed', 'no-answer', 'busy', etc.)
• duration: Call duration in seconds
• note: Call notes

Pitfalls:

• lead_id is required; calls must be associated with a lead
• Duration is in seconds, not minutes
• Call direction affects reporting and analytics
• contact_id is optional but recommended for tracking

3. Send SMS Messages

When to use: User wants to send or log SMS messages through Close

Tool sequence:

1. CLOSE_CREATE_SMS - Send or log an SMS message [Required]

Key parameters:

• lead_id: ID of the associated lead
• contact_id: ID of the contact
• direction: 'outbound' or 'inbound'
• text: SMS message content
• status: Message status

Pitfalls:

• SMS functionality requires Close phone/SMS integration to be configured
• lead_id is required for all SMS activities
• Outbound SMS may require a verified sending number
• Message length limits may apply depending on carrier

4. Manage Tasks

When to use: User wants to create or manage follow-up tasks

Tool sequence:

1. CLOSE_CREATE_TASK - Create a new task [Required]

Key parameters:

• lead_id: Associated lead ID
• text: Task description
• date: Due date for the task
• assigned_to: User ID of the assignee
• is_complete: Whether the task is completed

Pitfalls:

• Tasks are associated with leads, not contacts
• Date format should follow ISO 8601
• assigned_to requires the Close user ID, not email or name
• Tasks without a date appear in the 'no due date' section

5. Manage Notes

When to use: User wants to add or retrieve notes on leads

Tool sequence:

1. CLOSE_GET_NOTE - Retrieve a specific note [Required]

Key parameters:

• note_id: ID of the note to retrieve

Pitfalls:

• Notes are associated with leads
• Note IDs are required for retrieval; search leads first to find note references
• Notes support plain text and basic formatting

6. Delete Activities

When to use: User wants to remove call records or other activities

Tool sequence:

1. CLOSE_DELETE_CALL - Delete a call activity [Required]

Key parameters:

• call_id: ID of the call to delete

Pitfalls:

• Deletion is permanent and cannot be undone
• Only the call creator or admin can delete calls
• Deleting a call removes it from all reports and timelines

Common Patterns

Lead and Contact Relationship

Close data model:
- Lead = Company/Organization
  - Contact = Person (nested within Lead)
  - Activity = Call, SMS, Email, Note (linked to Lead)
  - Task = Follow-up item (linked to Lead)
  - Opportunity = Deal (linked to Lead)

ID Resolution

Lead ID:

1. Search for leads using the Close search API
2. Extract lead_id from results (format: 'lead_XXXXXXXXXXXXX')
3. Use lead_id in all activity creation calls

Contact ID:

1. Retrieve lead details to get nested contacts
2. Extract contact_id (format: 'cont_XXXXXXXXXXXXX')
3. Use in call/SMS activities for accurate tracking

Activity Logging Pattern

1. Identify the lead_id and optionally contact_id
2. Create the activity (call, SMS, note) with lead_id
3. Include relevant metadata (duration, direction, status)
4. Create follow-up tasks if needed

Known Pitfalls

ID Formats:

• Lead IDs: 'lead_XXXXXXXXXXXXX'
• Contact IDs: 'cont_XXXXXXXXXXXXX'
• Activity IDs vary by type: 'acti_XXXXXXXXXXXXX', 'call_XXXXXXXXXXXXX'
• Custom field IDs: 'custom.cf_XXXXXXXXXXXXX'
• Always use the full ID string

Rate Limits:

• Close API has rate limits based on your plan
• Implement delays between bulk operations
• Monitor response headers for rate limit status
• 429 responses require backoff

Custom Fields:

• Custom fields are referenced by their API ID, not display name
• Different lead statuses may have different required custom fields
• Custom field types (text, number, date, dropdown) enforce value formats

Data Integrity:

• Leads are the primary entity; contacts and activities are linked to leads
• Deleting a lead may cascade to its contacts and activities
• Bulk operations should validate IDs before executing

Quick Reference

Powered by Composio

Coda Automation via Rube MCP

Automate Coda document and data operations through Composio's Coda toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/coda

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Coda connection via RUBE_MANAGE_CONNECTIONS with toolkit coda
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit coda
3. If connection is not ACTIVE, follow the returned auth link to complete Coda authentication
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Search and Browse Documents

When to use: User wants to find, list, or inspect Coda documents

Tool sequence:

1. CODA_SEARCH_DOCS or CODA_LIST_AVAILABLE_DOCS - Find documents [Required]
2. CODA_RESOLVE_BROWSER_LINK - Resolve a Coda URL to doc/page/table IDs [Alternative]
3. CODA_LIST_PAGES - List pages within a document [Optional]
4. CODA_GET_A_PAGE - Get specific page details [Optional]

Key parameters:

• query: Search term for finding documents
• isOwner: Filter to docs owned by the user
• docId: Document ID for page operations
• pageIdOrName: Page identifier or name
• url: Browser URL for resolve operations

Pitfalls:

• Document IDs are alphanumeric strings (e.g., 'AbCdEfGhIj')
• CODA_RESOLVE_BROWSER_LINK is the best way to convert a Coda URL to API IDs
• Page names may not be unique within a doc; prefer page IDs
• Search results include docs shared with the user, not just owned docs

2. Work with Tables and Data

When to use: User wants to read, write, or query table data

Tool sequence:

1. CODA_LIST_TABLES - List tables in a document [Prerequisite]
2. CODA_LIST_COLUMNS - Get column definitions for a table [Prerequisite]
3. CODA_LIST_TABLE_ROWS - List all rows with optional filters [Required]
4. CODA_SEARCH_ROW - Search for specific rows by query [Alternative]
5. CODA_GET_A_ROW - Get a specific row by ID [Optional]
6. CODA_UPSERT_ROWS - Insert or update rows in a table [Optional]
7. CODA_GET_A_COLUMN - Get details of a specific column [Optional]

Key parameters:

• docId: Document ID containing the table
• tableIdOrName: Table identifier or name
• query: Filter query for searching rows
• rows: Array of row objects for upsert operations
• keyColumns: Column IDs used for matching during upsert
• sortBy: Column to sort results by
• useColumnNames: Use column names instead of IDs in row data

Pitfalls:

• Table names may contain spaces; URL-encode if needed
• CODA_UPSERT_ROWS does insert if no match on keyColumns, update if match found
• keyColumns must reference columns that have unique values for reliable upserts
• Column IDs are different from column names; list columns first to map names to IDs
• useColumnNames: true allows using human-readable names in row data
• Row data values must match the column type (text, number, date, etc.)

3. Manage Formulas

When to use: User wants to list or evaluate formulas in a document

Tool sequence:

1. CODA_LIST_FORMULAS - List all named formulas in a doc [Required]
2. CODA_GET_A_FORMULA - Get a specific formula's current value [Optional]

Key parameters:

• docId: Document ID
• formulaIdOrName: Formula identifier or name

Pitfalls:

• Formulas are named calculations defined in the document
• Formula values are computed server-side; results reflect the current state
• Formula names are case-sensitive

4. Export Document Content

When to use: User wants to export a document or page to HTML or Markdown

Tool sequence:

1. CODA_BEGIN_CONTENT_EXPORT - Start an export job [Required]
2. CODA_CONTENT_EXPORT_STATUS - Poll export status until complete [Required]

Key parameters:

• docId: Document ID to export
• outputFormat: Export format ('html' or 'markdown')
• pageIdOrName: Specific page to export (optional, omit for full doc)
• requestId: Export request ID for status polling

Pitfalls:

• Export is asynchronous; poll status until status is 'complete'
• Large documents may take significant time to export
• Export URL in the completed response is temporary; download promptly
• Polling too frequently may hit rate limits; use 2-5 second intervals

5. Manage Permissions and Sharing

When to use: User wants to view or manage document access

Tool sequence:

1. CODA_GET_SHARING_METADATA - View current sharing settings [Required]
2. CODA_GET_ACL_SETTINGS - Get access control list settings [Optional]
3. CODA_ADD_PERMISSION - Grant access to a user or email [Optional]

Key parameters:

• docId: Document ID
• access: Permission level ('readonly', 'write', 'comment')
• principal: Object with email or user ID of the recipient
• suppressEmail: Whether to skip the sharing notification email

Pitfalls:

• Permission levels: 'readonly', 'write', 'comment'
• Adding permission sends an email notification by default; use suppressEmail to prevent
• Cannot remove permissions via API in all cases; check ACL settings

6. Publish and Customize Documents

When to use: User wants to publish a document or manage custom domains

Tool sequence:

1. CODA_PUBLISH_DOC - Publish a document publicly [Required]
2. CODA_UNPUBLISH_DOC - Unpublish a document [Optional]
3. CODA_ADD_CUSTOM_DOMAIN - Add a custom domain for published doc [Optional]
4. CODA_GET_DOC_CATEGORIES - Get doc categories for discovery [Optional]

Key parameters:

• docId: Document ID
• slug: Custom URL slug for the published doc
• categoryIds: Category IDs for discoverability

Pitfalls:

• Publishing makes the document accessible to anyone with the link
• Custom domains require DNS configuration
• Unpublishing removes public access but retains shared access

Common Patterns

ID Resolution

Doc URL -> Doc ID:

1. Call CODA_RESOLVE_BROWSER_LINK with the Coda URL
2. Extract docId from the response

Table name -> Table ID:

1. Call CODA_LIST_TABLES with docId
2. Find table by name, extract id

Column name -> Column ID:

1. Call CODA_LIST_COLUMNS with docId and tableIdOrName
2. Find column by name, extract id

Pagination

• Coda uses cursor-based pagination with pageToken
• Check response for nextPageToken
• Pass as pageToken in next request until absent
• Default page sizes vary by endpoint

Row Upsert Pattern

1. Call CODA_LIST_COLUMNS to get column IDs
2. Build row objects with column ID keys and values
3. Set keyColumns to unique identifier column(s)
4. Call CODA_UPSERT_ROWS with rows and keyColumns

Known Pitfalls

ID Formats:

• Document IDs: alphanumeric strings
• Table/column/row IDs: prefixed strings (e.g., 'grid-abc', 'c-xyz')
• Use RESOLVE_BROWSER_LINK to convert URLs to IDs

Data Types:

• Row values must match column types
• Date columns expect ISO 8601 format
• Select/multi-select columns expect exact option values
• People columns expect email addresses

Rate Limits:

• Coda API has per-token rate limits
• Implement backoff on 429 responses
• Bulk row operations via UPSERT_ROWS are more efficient than individual updates

Quick Reference

Powered by Composio

Coding Agent PM

Use this skill when a human is preparing, delegating, reviewing, or recovering implementation work done by Claude Code, Codex, OpenClaw, or another coding agent.

When to Use This Skill

• You need to turn a vague implementation request into a bounded agent task.
• You are assigning work to one or more coding agents and need clear file ownership.
• You are reviewing an agent diff for scope drift, regressions, or missing validation.
• A coding agent has stalled, over-edited, or returned a result that is hard to trust.

What This Skill Does

1. Defines the shipped outcome in one sentence.
2. Sets explicit scope: files or modules owned, files or modules excluded, and destructive actions that are forbidden.
3. Captures relevant project context before implementation starts.
4. Writes acceptance criteria that can be checked directly.
5. Requires validation commands or manual checks before final delivery.
6. Reviews the diff before accepting the work.

Assignment Rules

• Keep the task brief concrete and bounded.
• State whether the agent may edit files or should only inspect and plan.
• Give ownership boundaries for code changes.
• Tell the agent not to revert unrelated user work.
• Prefer existing project patterns over new abstractions.
• Require the final response to include changed files, checks run, results, and remaining risks.

Agent Brief Template

# Agent Brief

## Outcome
Ship:

## Scope
Owned files/modules:

Do not edit:

Forbidden actions:
- Do not run destructive git commands.
- Do not revert unrelated user changes.

## Context
Relevant files:

Existing patterns to follow:

## Acceptance Criteria
- [ ] 
- [ ] 
- [ ] 

## Validation
Run:

Manual checks:

## Final Response Must Include
- Files changed
- Validation run and result
- Remaining risks or follow-ups

Review Checklist

Review in this order:

1. Behavioral bugs or regressions.
2. Missing acceptance criteria.
3. Missing tests or weak validation.
4. Scope drift and unrelated refactors.
5. Security, privacy, or destructive-command risk.

If the agent drifted, stop new edits and ask it to map each change back to the original acceptance criteria.

Recovery Prompt

Use this when a coding agent's work is hard to trust:

Pause implementation. Map every changed file and every material change back to the original acceptance criteria. For each change, mark it as required, optional, or unrelated. Do not edit files until this map is complete.

Example

User: "Have a coding agent add OAuth login."

Better assignment:

Outcome: Add GitHub OAuth login to the existing auth flow.

Scope:
- Own: src/auth/*, src/routes/login.tsx, tests/auth/*
- Do not edit: billing, onboarding, database migrations unless a failing test proves it is required

Acceptance criteria:
- [ ] Existing email login still works.
- [ ] GitHub login creates or links a user through the existing auth service.
- [ ] Auth errors render through the existing form error pattern.
- [ ] Tests cover success, denied OAuth, and existing linked account.

Validation:
- npm test -- auth
- npm run lint

Tips

• The smaller the owned file set, the better the agent result.
• Make "do not edit" lists explicit for shared or risky modules.
• Prefer acceptance criteria over long implementation instructions.
• Treat validation as part of the task, not a follow-up.

CoinPaprika API

Access cryptocurrency market data for 12,000+ coins and 350+ exchanges via the CoinPaprika MCP server.

Setup

Add the MCP server to your Claude Code config:

{
  "mcpServers": {
    "coinpaprika": {
      "url": "https://mcp.coinpaprika.com/sse"
    }
  }
}

Or install the full plugin (includes agent + skill):

/plugin marketplace add coinpaprika/claude-marketplace
/plugin install coinpaprika@coinpaprika-plugins

Available MCP Tools (29)

• getGlobal — Total market cap, BTC dominance, 24h volume
• getTickers / getTickersById — Price, market cap, volume for coins
• getTickersHistoricalById — Historical price ticks
• getCoins / getCoinById — Coin details, descriptions, links, teams
• getCoinEvents / getCoinExchanges / getCoinMarkets — Events, exchange listings, trading pairs
• getCoinOHLCVHistorical / getCoinOHLCVLatest / getCoinOHLCVToday — Candlestick data
• getExchanges / getExchangeByID / getExchangeMarkets — Exchange data
• getPlatforms / getContracts / getTickerByContract / getHistoricalTickerByContract — Contract lookups
• search / resolveId — Find coins, exchanges, people, tags
• priceConverter — Convert between currencies
• getTags / getTagById / getPeopleById — Categories and team info
• keyInfo / getMappings / getChangelogIDs / status — Account and metadata

Coin ID Format

Pattern: {symbol}-{name} lowercase. Examples: btc-bitcoin, eth-ethereum, sol-solana.

Use search or resolveId if unsure of the correct ID.

Rate Limits

• Free tier: 20,000 calls/month, no API key needed
• Pro tier: higher limits via api-pro.coinpaprika.com
• Docs: https://docs.coinpaprika.com

Competitive Ads Extractor

This skill extracts your competitors' ads from ad libraries and analyzes what's working—the problems they're highlighting, use cases they're targeting, and copy/creative that's resonating.

When to Use This Skill

• Researching competitor ad strategies
• Finding inspiration for your own ads
• Understanding market positioning
• Identifying successful ad patterns
• Analyzing messaging that works
• Discovering new use cases or pain points
• Planning ad campaigns with proven concepts

What This Skill Does

1. Extracts Ads: Scrapes ads from Facebook Ad Library, LinkedIn, etc.
2. Captures Screenshots: Saves visual copies of all ads
3. Analyzes Messaging: Identifies problems, use cases, and value props
4. Categorizes Ads: Groups by theme, audience, or format
5. Identifies Patterns: Finds common successful approaches
6. Provides Insights: Explains why certain ads likely perform well

How to Use

Basic Extraction

Extract all current ads from [Competitor Name] on Facebook Ad Library

Scrape ads from [Company] and analyze their messaging

Specific Analysis

Get all ads from [Competitor] focusing on their messaging 
about [specific problem]. What pain points are they highlighting?

Competitive Set

Extract ads from these 5 competitors: [list]. 
Compare their approaches and tell me what's working.

Specific Platform

Get LinkedIn ads from [Competitor] and analyze their 
B2B positioning strategy

Example

User: "Extract ads from Notion on Facebook Ad Library and tell me what messaging is working for them."

Process:

Accessing Facebook Ad Library...
Searching for: Notion
Found: 23 active ads

Extracting screenshots...
[████████████████████] 100%

Saved to: competitor-ads/notion/
- ad-001-collaboration.png
- ad-002-productivity.png
- ad-003-templates.png
...

Analyzing messaging...

Output:

# Notion Ad Analysis

## Overview
- Total Ads: 23 active
- Primary Themes: Productivity (35%), Collaboration (30%), 
  Templates (20%), AI Features (15%)
- Ad Formats: Static images (60%), Video (40%)
- CTA Patterns: "Try for free", "Get started"

## Key Problems They're Highlighting

1. **Scattered Information** (8 ads)
   Copy: "Stop switching between 10 different tools"
   Why it works: Direct pain point many teams face

2. **Meeting Overload** (5 ads)
   Copy: "Replace unnecessary meetings with async updates"
   Why it works: Post-COVID remote work pain point

3. **Lost Documentation** (4 ads)
   Copy: "Never ask 'where is that doc?' again"
   Why it works: Universal workplace frustration

## Successful Creative Patterns

### Pattern 1: Before/After Split
- Shows chaotic tool landscape → Clean Notion workspace
- Used in 6 high-performing ads
- Visual metaphor is immediately clear

### Pattern 2: Feature Showcase
- GIF of actual product usage
- Shows specific feature in 5 seconds
- Used for new features (AI, templates)

### Pattern 3: Social Proof
- "Join 20M users" messaging
- Customer logos
- Used in 4 ads targeting enterprise

## Copy That's Working

Best Headlines:
1. "Your team's knowledge, finally in one place"
   → Benefit-focused, addresses pain directly
   
2. "The all-in-one workspace"
   → Clear positioning, broad appeal
   
3. "AI that actually helps you work"
   → Addresses AI skepticism, practical angle

Best Body Copy Patterns:
- Short sentences (under 10 words)
- Focus on outcomes not features
- Include specific numbers ("Cut meetings by 50%")

## Audience Targeting Insights

Based on ad variations:
- Startup founders: Solo productivity angle
- Team leads: Collaboration and alignment
- Enterprise: Security and compliance mentions
- Students: Free plan, templates, organization

## Recommendations for Your Ads

1. **Test the "tool sprawl" pain point**
   → Strong resonance based on their ad frequency

2. **Use product screenshots over abstract visuals**
   → All their top ads show actual UI

3. **Lead with the problem, not the solution**
   → "Tired of X?" performs better than "Introducing Y"

4. **Keep copy under 100 characters**
   → Their shortest ads seem most frequent

5. **Test before/after visual formats**
   → Proven pattern in their creative

## Files Saved
- All ads: ~/competitor-ads/notion/
- Analysis: ~/competitor-ads/notion/analysis.md
- Best performers: ~/competitor-ads/notion/top-10/

Inspired by: Sumant Subrahmanya's use case from Lenny's Newsletter

What You Can Learn

Messaging Analysis

• What problems they emphasize
• How they position against competition
• Value propositions that resonate
• Target audience segments

Creative Patterns

• Visual styles that work
• Video vs. static image performance
• Color schemes and branding
• Layout patterns

Copy Formulas

• Headline structures
• Call-to-action patterns
• Length and tone
• Emotional triggers

Campaign Strategy

• Seasonal campaigns
• Product launch approaches
• Feature announcement tactics
• Retargeting patterns

Best Practices

Legal & Ethical

✓ Only use for research and inspiration ✓ Don't copy ads directly ✓ Respect intellectual property ✓ Use insights to inform original creative ✗ Don't plagiarize copy or steal designs

Analysis Tips

1. Look for patterns: What themes repeat?
2. Track over time: Save ads monthly to see evolution
3. Test hypotheses: Adapt successful patterns for your brand
4. Segment by audience: Different messages for different targets
5. Compare platforms: LinkedIn vs Facebook messaging differs

Advanced Features

Trend Tracking

Compare [Competitor]'s ads from Q1 vs Q2. 
What messaging has changed?

Multi-Competitor Analysis

Extract ads from [Company A], [Company B], [Company C]. 
What are the common patterns? Where do they differ?

Industry Benchmarks

Show me ad patterns across the top 10 project management 
tools. What problems do they all focus on?

Format Analysis

Analyze video ads vs static image ads from [Competitor]. 
Which gets more engagement? (if data available)

Common Workflows

Ad Campaign Planning

1. Extract competitor ads
2. Identify successful patterns
3. Note gaps in their messaging
4. Brainstorm unique angles
5. Draft test ad variations

Positioning Research

1. Get ads from 5 competitors
2. Map their positioning
3. Find underserved angles
4. Develop differentiated messaging
5. Test against their approaches

Creative Inspiration

1. Extract ads by theme
2. Analyze visual patterns
3. Note color and layout trends
4. Adapt successful patterns
5. Create original variations