skill-library-mcp 1.0.0

package/skills/team-composition-analysis/SKILL.md

@@ -0,0 +1,413 @@
+---
+name: team-composition-analysis
+description: This skill should be used when the user asks to "plan team
+  structure", "determine hiring needs", "design org chart", "calculate
+  compensation", "plan equity allocation", or requests organizational design and
+  headcount planning for a startup.
+metadata:
+  version: 1.0.0
+---
+
+# Team Composition Analysis
+
+Design optimal team structures, hiring plans, compensation strategies, and equity allocation for early-stage startups from pre-seed through Series A.
+
+## Use this skill when
+
+- Working on team composition analysis tasks or workflows
+- Needing guidance, best practices, or checklists for team composition analysis
+
+## Do not use this skill when
+
+- The task is unrelated to team composition analysis
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+## Overview
+
+Build the right team at the right time with appropriate compensation and equity. Plan role-by-role hiring aligned with revenue milestones, budget constraints, and market benchmarks.
+
+## Team Structure by Stage
+
+### Pre-Seed (0-$500K ARR)
+
+**Team Size: 2-5 people**
+
+**Core Roles:**
+- Founders (2-3): Product, engineering, business
+- First engineer (if needed)
+- Contract roles: Design, marketing
+
+**Focus:** Build and validate product-market fit
+
+### Seed ($500K-$2M ARR)
+
+**Team Size: 5-15 people**
+
+**Key Hires:**
+- Engineering lead + 2-3 engineers
+- First sales/business development
+- Product manager
+- Marketing/growth lead
+
+**Focus:** Scale product and prove repeatable sales
+
+### Series A ($2M-$10M ARR)
+
+**Team Size: 15-50 people**
+
+**Department Build-Out:**
+- Engineering (40%): 6-20 people
+- Sales & Marketing (30%): 5-15 people
+- Customer Success (10%): 2-5 people
+- G&A (10%): 2-5 people
+- Product (10%): 2-5 people
+
+**Focus:** Scale revenue and build repeatable processes
+
+## Role-by-Role Planning
+
+### Engineering Team
+
+**Pre-Seed:**
+- Founders write code
+- 0-1 contract developers
+
+**Seed:**
+- Engineering Lead (first $150K-$180K)
+- 2-3 Full-Stack Engineers ($120K-$150K)
+- 1 Frontend or Backend Specialist ($130K-$160K)
+
+**Series A:**
+- VP Engineering ($180K-$250K + equity)
+- 2-3 Senior Engineers ($150K-$180K)
+- 3-5 Mid-Level Engineers ($120K-$150K)
+- 1-2 Junior Engineers ($90K-$120K)
+- 1 DevOps/Infrastructure ($140K-$170K)
+
+### Sales & Marketing
+
+**Pre-Seed:**
+- Founders do sales
+- Contract marketing help
+
+**Seed:**
+- First Sales Hire / Head of Sales ($120K-$150K + commission)
+- Marketing/Growth Lead ($100K-$140K)
+- SDR or BDR (if B2B) ($50K-$70K + commission)
+
+**Series A:**
+- VP Sales ($150K-$200K + commission + equity)
+- 3-5 Account Executives ($80K-$120K + commission)
+- 2-3 SDRs/BDRs ($50K-$70K + commission)
+- Marketing Manager ($90K-$130K)
+- Content/Demand Gen ($70K-$100K)
+
+### Product Team
+
+**Pre-Seed:**
+- Founder as product lead
+
+**Seed:**
+- First Product Manager ($120K-$150K)
+- Contract designer
+
+**Series A:**
+- Head of Product ($150K-$180K)
+- 1-2 Product Managers ($120K-$150K)
+- Product Designer ($100K-$140K)
+- UX Researcher (optional) ($90K-$130K)
+
+### Customer Success
+
+**Pre-Seed:**
+- Founders handle support
+
+**Seed:**
+- First CS hire (optional) ($60K-$90K)
+
+**Series A:**
+- CS Manager ($100K-$130K)
+- 2-4 CS Representatives ($60K-$90K)
+- Support Engineer (technical) ($80K-$120K)
+
+### G&A (General & Administrative)
+
+**Pre-Seed:**
+- Contractors (accounting, legal)
+
+**Seed:**
+- Operations/Office Manager ($70K-$100K)
+- Contract CFO
+
+**Series A:**
+- CFO or Finance Lead ($150K-$200K)
+- Recruiter ($80K-$120K)
+- Office Manager / EA ($60K-$90K)
+
+## Compensation Strategy
+
+### Base Salary Benchmarks (US, 2024)
+
+**Engineering:**
+- Junior: $90K-$120K
+- Mid-Level: $120K-$150K
+- Senior: $150K-$180K
+- Staff/Principal: $180K-$220K
+- Engineering Manager: $160K-$200K
+- VP Engineering: $180K-$250K
+
+**Sales:**
+- SDR/BDR: $50K-$70K base + $50K-$70K commission
+- Account Executive: $80K-$120K base + $80K-$120K commission
+- Sales Manager: $120K-$160K base + $80K-$120K commission
+- VP Sales: $150K-$200K base + $150K-$200K commission
+
+**Product:**
+- Product Manager: $120K-$150K
+- Senior PM: $150K-$180K
+- Head of Product: $150K-$180K
+- VP Product: $180K-$220K
+
+**Marketing:**
+- Marketing Manager: $90K-$130K
+- Content/Demand Gen: $70K-$100K
+- Head of Marketing: $130K-$170K
+- VP Marketing: $150K-$200K
+
+**Customer Success:**
+- CS Representative: $60K-$90K
+- CS Manager: $100K-$130K
+- VP Customer Success: $140K-$180K
+
+### Total Compensation Formula
+
+```
+Total Comp = Base Salary × 1.30 (benefits & taxes) + Equity Value
+```
+
+**Fully-Loaded Cost:**
+- Base salary
+- Payroll taxes (7.65% FICA)
+- Benefits (health insurance, 401k): $10K-$15K per employee
+- Other (workspace, equipment, software): $5K-$10K per employee
+
+**Rule of Thumb:** Multiply base salary by 1.3-1.4 for fully-loaded cost
+
+### Geographic Adjustments
+
+**San Francisco / New York:** +20-30% above benchmarks
+**Seattle / Boston / Los Angeles:** +10-20%
+**Austin / Denver / Chicago:** +0-10%
+**Remote / Other US Cities:** -10-20%
+**International:** Varies widely by country
+
+## Equity Allocation
+
+### Equity by Role and Stage
+
+**Founders:**
+- First founder: 40-60%
+- Second founder: 20-40%
+- Third founder: 10-20%
+- Vesting: 4 years with 1-year cliff
+
+**Early Employees (Pre-Seed):**
+- First engineer: 0.5-2.0%
+- First 5 employees: 0.25-1.0% each
+
+**Seed Stage Hires:**
+- VP/Head level: 0.5-1.5%
+- Senior IC: 0.1-0.5%
+- Mid-level: 0.05-0.25%
+- Junior: 0.01-0.1%
+
+**Series A Hires:**
+- C-level (CTO, CFO): 1.0-3.0%
+- VP level: 0.3-1.0%
+- Director level: 0.1-0.5%
+- Senior IC: 0.05-0.2%
+- Mid-level: 0.01-0.1%
+- Junior: 0.005-0.05%
+
+### Equity Pool Sizing
+
+**Option Pool by Round:**
+- Pre-Seed: 10-15% reserved
+- Seed: 10-15% top-up
+- Series A: 10-15% top-up
+- Series B+: 5-10% per round
+
+**Pre-Funding Dilution:**
+Investors often require option pool creation before investment, diluting founders.
+
+**Example:**
+```
+Pre-money: $10M
+Investors want 15% option pool post-money
+
+Calculation:
+Post-money: $15M ($10M + $5M investment)
+Option pool: $2.25M (15% × $15M)
+Founders diluted by pool creation before new money
+```
+
+## Organizational Design
+
+### Reporting Structure
+
+**Pre-Seed:**
+```
+Founders (flat structure)
+├── Contractors
+└── First hires (report to founders)
+```
+
+**Seed:**
+```
+CEO
+├── Engineering Lead (2-4 engineers)
+├── Sales/Growth Lead (1-2 reps)
+├── Product Manager
+└── Operations
+```
+
+**Series A:**
+```
+CEO
+├── CTO / VP Engineering (6-20 people)
+│   ├── Engineering Manager(s)
+│   └── Individual Contributors
+├── VP Sales (5-15 people)
+│   ├── Sales Manager
+│   ├── Account Executives
+│   └── SDRs
+├── Head of Product (2-5 people)
+│   ├── Product Managers
+│   └── Designers
+├── Head of Customer Success (2-5 people)
+└── CFO / Finance Lead (2-5 people)
+    ├── Recruiter
+    └── Operations
+```
+
+### Span of Control
+
+**Manager Ratios:**
+- First-line managers: 4-8 direct reports
+- Directors: 3-5 direct reports (managers)
+- VPs: 3-5 direct reports (directors)
+- CEO: 5-8 direct reports (executive team)
+
+## Full-Time vs. Contract
+
+### Use Full-Time for:
+- Core product development
+- Sales (revenue-generating roles)
+- Mission-critical operations
+- Institutional knowledge roles
+
+### Use Contractors for:
+- Specialized short-term needs (legal, accounting)
+- Variable workload (design, marketing campaigns)
+- Skills outside core competency
+- Testing role before FTE hire
+- Geographic expansion before permanent presence
+
+### Cost Comparison
+
+**Full-Time:**
+- Lower hourly cost
+- Benefits and overhead
+- Long-term commitment
+- Cultural fit matters
+
+**Contract:**
+- Higher hourly rate ($75-$200/hour vs. $40-$100/hour FTE equivalent)
+- No benefits or overhead
+- Flexible engagement
+- Easier to scale up/down
+
+## Hiring Velocity
+
+### Realistic Timeline
+
+**Role Opening to Hire:**
+- Junior: 6-8 weeks
+- Mid-Level: 8-12 weeks
+- Senior: 12-16 weeks
+- Executive: 16-24 weeks
+
+**Time to Productivity:**
+- Junior: 4-6 months
+- Mid-Level: 2-4 months
+- Senior: 1-3 months
+- Executive: 3-6 months
+
+### Planning Buffer
+
+Always add 2-3 months buffer to hiring plans.
+
+**Example:**
+If need engineer by July 1:
+- Start recruiting: April 1 (12 weeks)
+- Productivity: September 1 (2 months ramp)
+
+## Budget Planning
+
+### Compensation as % of Revenue
+
+**Early Stage (Seed):**
+- Total comp: 120-150% of revenue (burning cash to grow)
+- Engineering: 50-60%
+- Sales: 30-40%
+- Other: 20-30%
+
+**Growth Stage (Series A):**
+- Total comp: 70-100% of revenue
+- Engineering: 35-45%
+- Sales: 25-35%
+- Other: 20-30%
+
+### Headcount Budget Formula
+
+```
+Total Comp Budget = Σ (Role Count × Fully-Loaded Cost × % of Year)
+
+Example:
+3 Engineers × $202K × 100% = $606K
+2 AEs × $230K × 75% (mid-year start) = $345K
+1 PM × $162K × 100% = $162K
+Total: $1.1M
+```
+
+## Additional Resources
+
+### Reference Files
+- **`references/compensation-benchmarks.md`** - Detailed salary data by role, level, and location
+- **`references/equity-calculator.md`** - Equity sizing formulas and dilution scenarios
+
+### Example Files
+- **`examples/seed-stage-hiring-plan.md`** - Complete hiring plan for seed-stage SaaS company
+- **`examples/org-chart-evolution.md`** - Organizational design from 5 to 50 people
+
+## Quick Start
+
+To plan team composition:
+
+1. **Identify stage** - Pre-seed, seed, or Series A
+2. **Define roles** - What functions are needed now
+3. **Prioritize hires** - Critical path for business goals
+4. **Set compensation** - Base salary + equity by level
+5. **Plan timeline** - Account for recruiting and ramp time
+6. **Calculate budget** - Fully-loaded cost × headcount
+7. **Design org chart** - Reporting structure and span of control
+8. **Allocate equity** - Fair allocation that preserves pool
+
+For detailed compensation benchmarks and hiring plan templates, see `references/` and `examples/`.

package/skills/telegram-automation/SKILL.md

@@ -0,0 +1,219 @@
+---
+name: telegram-automation
+description: "Automate Telegram tasks via Rube MCP (Composio): send messages, manage chats, share photos/documents, and handle bot commands. Always search tools first for current schemas."
+requires:
+  mcp: [rube]
+---
+
+# Telegram Automation via Rube MCP
+
+Automate Telegram operations through Composio's Telegram toolkit via Rube MCP.
+
+## Prerequisites
+
+- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
+- Active Telegram connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `telegram`
+- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas
+- Telegram Bot Token required (created via @BotFather)
+
+## 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 `telegram`
+3. If connection is not ACTIVE, follow the returned auth link to configure the Telegram bot
+4. Confirm connection status shows ACTIVE before running any workflows
+
+## Core Workflows
+
+### 1. Send Messages
+
+**When to use**: User wants to send text messages to a Telegram chat
+
+**Tool sequence**:
+1. `TELEGRAM_GET_ME` - Verify bot identity and connection [Prerequisite]
+2. `TELEGRAM_GET_CHAT` - Get chat details and verify access [Optional]
+3. `TELEGRAM_SEND_MESSAGE` - Send a text message [Required]
+
+**Key parameters**:
+- `chat_id`: Numeric chat ID or channel username (e.g., '@channelname')
+- `text`: Message text content
+- `parse_mode`: 'HTML' or 'MarkdownV2' for formatting
+- `disable_notification`: Send silently without notification sound
+- `reply_to_message_id`: Message ID to reply to
+
+**Pitfalls**:
+- Bot must be a member of the chat/group to send messages
+- MarkdownV2 requires escaping special characters: `_*[]()~>#+-=|{}.!`
+- HTML mode supports limited tags: `<b>`, `<i>`, `<code>`, `<pre>`, `<a>`
+- Messages have a 4096 character limit; split longer content
+
+### 2. Send Photos and Documents
+
+**When to use**: User wants to share images or files in a Telegram chat
+
+**Tool sequence**:
+1. `TELEGRAM_SEND_PHOTO` - Send an image [Optional]
+2. `TELEGRAM_SEND_DOCUMENT` - Send a file/document [Optional]
+
+**Key parameters**:
+- `chat_id`: Target chat ID
+- `photo`: Photo URL or file_id (for SEND_PHOTO)
+- `document`: Document URL or file_id (for SEND_DOCUMENT)
+- `caption`: Optional caption for the media
+
+**Pitfalls**:
+- Photo captions have a 1024 character limit
+- Document captions also have a 1024 character limit
+- Files up to 50MB can be sent via bot API
+- Photos are compressed by Telegram; use SEND_DOCUMENT for uncompressed images
+
+### 3. Manage Chats
+
+**When to use**: User wants to get chat information or manage chat settings
+
+**Tool sequence**:
+1. `TELEGRAM_GET_CHAT` - Get detailed chat information [Required]
+2. `TELEGRAM_GET_CHAT_ADMINISTRATORS` - List chat admins [Optional]
+3. `TELEGRAM_GET_CHAT_MEMBERS_COUNT` - Get member count [Optional]
+4. `TELEGRAM_EXPORT_CHAT_INVITE_LINK` - Generate invite link [Optional]
+
+**Key parameters**:
+- `chat_id`: Target chat ID or username
+
+**Pitfalls**:
+- Bot must be an administrator to export invite links
+- GET_CHAT returns different fields for private chats vs groups vs channels
+- Member count may be approximate for very large groups
+- Admin list does not include regular members
+
+### 4. Edit and Delete Messages
+
+**When to use**: User wants to modify or remove previously sent messages
+
+**Tool sequence**:
+1. `TELEGRAM_EDIT_MESSAGE` - Edit a sent message [Optional]
+2. `TELEGRAM_DELETE_MESSAGE` - Delete a message [Optional]
+
+**Key parameters**:
+- `chat_id`: Chat where the message is located
+- `message_id`: ID of the message to edit or delete
+- `text`: New text content (for edit)
+
+**Pitfalls**:
+- Bots can only edit their own messages
+- Messages can only be deleted within 48 hours of sending
+- In groups, bots with delete permissions can delete any message
+- Editing a message removes its 'edited' timestamp history
+
+### 5. Forward Messages and Get Updates
+
+**When to use**: User wants to forward messages or retrieve recent updates
+
+**Tool sequence**:
+1. `TELEGRAM_FORWARD_MESSAGE` - Forward a message to another chat [Optional]
+2. `TELEGRAM_GET_UPDATES` - Get recent bot updates/messages [Optional]
+3. `TELEGRAM_GET_CHAT_HISTORY` - Get chat message history [Optional]
+
+**Key parameters**:
+- `from_chat_id`: Source chat for forwarding
+- `chat_id`: Destination chat for forwarding
+- `message_id`: Message to forward
+- `offset`: Update offset for GET_UPDATES
+- `limit`: Number of updates to retrieve
+
+**Pitfalls**:
+- Forwarded messages show the original sender attribution
+- GET_UPDATES returns a limited window of recent updates
+- Chat history access may be limited by bot permissions and chat type
+- Use offset to avoid processing the same update twice
+
+### 6. Manage Bot Commands
+
+**When to use**: User wants to set or update bot command menu
+
+**Tool sequence**:
+1. `TELEGRAM_SET_MY_COMMANDS` - Set the bot's command list [Required]
+2. `TELEGRAM_ANSWER_CALLBACK_QUERY` - Respond to inline button presses [Optional]
+
+**Key parameters**:
+- `commands`: Array of command objects with `command` and `description`
+- `callback_query_id`: ID of the callback query to answer
+
+**Pitfalls**:
+- Commands must start with '/' and be lowercase
+- Command descriptions have a 256 character limit
+- Callback queries must be answered within 10 seconds or they expire
+- Setting commands replaces the entire command list
+
+## Common Patterns
+
+### Chat ID Resolution
+
+**From username**:
+```
+1. Use '@username' format as chat_id (for public channels/groups)
+2. For private chats, numeric chat_id is required
+3. Call GET_CHAT with username to retrieve numeric ID
+```
+
+**From GET_UPDATES**:
+```
+1. Call TELEGRAM_GET_UPDATES
+2. Extract chat.id from message objects
+3. Use numeric chat_id in subsequent calls
+```
+
+### Message Formatting
+
+- Use `parse_mode: 'HTML'` for `<b>bold</b>`, `<i>italic</i>`, `<code>code</code>`
+- Use `parse_mode: 'MarkdownV2'` for `*bold*`, `_italic_`, `` `code` ``
+- Escape special chars in MarkdownV2: `_ * [ ] ( ) ~ > # + - = | { } . !`
+- Omit parse_mode for plain text without formatting
+
+## Known Pitfalls
+
+**Bot Permissions**:
+- Bots must be added to groups/channels to interact
+- Admin permissions needed for: deleting messages, exporting invite links, managing members
+- Bots cannot initiate conversations; users must start them first
+
+**Rate Limits**:
+- 30 messages per second to the same group
+- 20 messages per minute to the same user in groups
+- Bulk operations should implement delays between calls
+- API returns 429 Too Many Requests when limits are hit
+
+**Chat Types**:
+- Private chat: One-on-one with the bot
+- Group: Multi-user chat (bot must be added)
+- Supergroup: Enhanced group with admin features
+- Channel: Broadcast-only (bot must be admin to post)
+
+**Message Limits**:
+- Text messages: 4096 characters max
+- Captions: 1024 characters max
+- File uploads: 50MB max via bot API
+- Inline keyboard buttons: 8 per row
+
+## Quick Reference
+
+| Task | Tool Slug | Key Params |
+|------|-----------|------------|
+| Verify bot | TELEGRAM_GET_ME | (none) |
+| Send message | TELEGRAM_SEND_MESSAGE | chat_id, text, parse_mode |
+| Send photo | TELEGRAM_SEND_PHOTO | chat_id, photo, caption |
+| Send document | TELEGRAM_SEND_DOCUMENT | chat_id, document, caption |
+| Edit message | TELEGRAM_EDIT_MESSAGE | chat_id, message_id, text |
+| Delete message | TELEGRAM_DELETE_MESSAGE | chat_id, message_id |
+| Forward message | TELEGRAM_FORWARD_MESSAGE | chat_id, from_chat_id, message_id |
+| Get chat info | TELEGRAM_GET_CHAT | chat_id |
+| Get chat admins | TELEGRAM_GET_CHAT_ADMINISTRATORS | chat_id |
+| Get member count | TELEGRAM_GET_CHAT_MEMBERS_COUNT | chat_id |
+| Export invite link | TELEGRAM_EXPORT_CHAT_INVITE_LINK | chat_id |
+| Get updates | TELEGRAM_GET_UPDATES | offset, limit |
+| Get chat history | TELEGRAM_GET_CHAT_HISTORY | chat_id |
+| Set bot commands | TELEGRAM_SET_MY_COMMANDS | commands |
+| Answer callback | TELEGRAM_ANSWER_CALLBACK_QUERY | callback_query_id |