{
  "markdown": "# MachFive Skills\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Agent Skills](https://img.shields.io/badge/Open_Standard-Agent_Skills-blue.svg)](https://agentskills.io)\n[![MachFive](https://img.shields.io/badge/Powered_by-MachFive-orange.svg)](https://machfive.io)\n\nAgent Skills that connect any AI coding agent to [MachFive](https://machfive.io) — generate hyper-personalized cold email sequences directly from your AI workflows.\n\nCompatible with **Claude Code**, **OpenAI Codex CLI**, **Gemini CLI**, and any tool that supports the [Agent Skills open standard](https://agentskills.io).\n\n---\n\n## What Is This?\n\nThis repository contains [Agent Skills](https://agentskills.io) that teach your AI agent how to use the MachFive API. Instead of switching between your agent and a separate tool, your agent autonomously calls MachFive to list campaigns, generate personalized email sequences, manage batch jobs, and export results — all through natural conversation.\n\n**This is not a prompt template.** It's a live API integration — the agent calls the MachFive platform and returns real generated emails for your actual leads.\n\n---\n\n## Skills\n\n| Skill | Triggers | What It Does |\n|-------|---------|--------------|\n| [`cold-email`](./cold-email/) | Cold email, outreach sequences, lead prospecting, email campaigns | Connects to the MachFive API to generate personalized email sequences for individual leads or batches |\n\n---\n\n## Install\n\n### Claude Code\n\n**Via plugin marketplace (recommended):**\n```\n/plugin marketplace add Bluecraft-AI/machfive-skills\n/plugin install cold-email@machfive-skills\n```\n\n**Manual — personal (all projects):**\n```bash\ngit clone https://github.com/Bluecraft-AI/machfive-skills.git\ncp -r machfive-skills/cold-email/skills/cold-email ~/.claude/skills/\n```\n\n**Manual — project (shared with your team via git):**\n```bash\ncp -r machfive-skills/cold-email/skills/cold-email .claude/skills/\n```\n\n### OpenAI Codex CLI\n\n**Personal:**\n```bash\ngit clone https://github.com/Bluecraft-AI/machfive-skills.git\ncp -r machfive-skills/cold-email/skills/cold-email ~/.agents/skills/\n```\n\n**Project:**\n```bash\ncp -r machfive-skills/cold-email/skills/cold-email .agents/skills/\n```\n\n### Gemini CLI\n\n**Personal:**\n```bash\ngit clone https://github.com/Bluecraft-AI/machfive-skills.git\ncp -r machfive-skills/cold-email/skills/cold-email ~/.gemini/skills/\n```\n\n**Project:**\n```bash\ncp -r machfive-skills/cold-email/skills/cold-email .gemini/skills/\n```\n\n### Universal (Codex CLI, Gemini CLI, VS Code Copilot, OpenClaw, Kiro, and others)\n\nMost agent tools discover skills from a shared cross-platform directory:\n```bash\ngit clone https://github.com/Bluecraft-AI/machfive-skills.git\ncp -r machfive-skills/cold-email/skills/cold-email ~/.agents/skills/\n```\n\n---\n\n## Prerequisites\n\nYou need a MachFive API key and at least one campaign set up.\n\n**Step 1: Get your API key**\n\n1. Log in at [app.machfive.io](https://app.machfive.io)\n2. Go to **Settings → Integrations → API Keys**\n3. Click **Create API Key** and copy it\n\n**Step 2: Set your environment variable**\n\n```bash\nexport MACHFIVE_API_KEY=your_api_key_here\n```\n\nAdd it to your shell profile (`.zshrc`, `.bashrc`, etc.) to persist across sessions.\n\n**Step 3: Create a campaign**\n\nThe skill requires a campaign to generate against. Create one at [app.machfive.io/campaigns](https://app.machfive.io/campaigns). If you haven't specified a campaign, the agent will automatically list your available campaigns and ask you to pick one.\n\n---\n\n## What Your Agent Can Do\n\nOnce installed, the skill activates automatically when you ask about cold email, outreach, or lead sequencing. No slash command needed.\n\n**Single lead**\n```\nGenerate a 3-email sequence for jane@acme.com — she's VP of Growth at Acme Corp.\nUse my SaaS Founders campaign.\n```\n\n**Batch**\n```\nHere are 20 leads [paste list]. Submit them for batch generation\nusing my Marketing Agencies campaign.\n```\n\n**Check status**\n```\nWhat's the status of my latest batch?\n```\n\n**Export**\n```\nExport my completed batch as CSV.\n```\n\n**Browse campaigns**\n```\nShow me my MachFive campaigns.\n```\n\n---\n\n## How It Works\n\nThe skill gives your agent full knowledge of the MachFive API:\n\n| Endpoint | What the agent uses it for |\n|----------|---------------------------|\n| `GET /api/v1/campaigns` | Lists your campaigns so you can pick one |\n| `POST /api/v1/campaigns/{id}/generate` | Generates a sequence for one lead (sync) |\n| `POST /api/v1/campaigns/{id}/generate-batch` | Submits multiple leads for async processing |\n| `GET /api/v1/lists` | Browses your lead lists and batch jobs |\n| `GET /api/v1/lists/{id}` | Polls batch status until complete |\n| `GET /api/v1/lists/{id}/export` | Downloads results as CSV or JSON |\n\nThe agent handles the full workflow autonomously, including polling for batch completion.\n\n---\n\n## MachFive MCP Server\n\nIf you prefer MCP (Model Context Protocol) over Agent Skills, MachFive also has a dedicated MCP server that provides the same capabilities as structured tools:\n\n👉 [github.com/Bluecraft-AI/machfive-mcp](https://github.com/Bluecraft-AI/machfive-mcp)\n\nThe MCP server works with Claude Desktop, Cursor, n8n, and any MCP-compatible client.\n\n---\n\n## Repository Structure\n\n```\nmachfive-skills/\n├── .claude-plugin/\n│   └── marketplace.json          ← Claude Code marketplace catalog\n├── cold-email/                   ← Claude Code plugin\n│   ├── .claude-plugin/\n│   │   └── plugin.json           ← plugin identity & metadata\n│   └── skills/\n│       └── cold-email/\n│           └── SKILL.md          ← agent instructions (all platforms)\n├── LICENSE\n└── README.md\n```\n\nThe `skills/cold-email/SKILL.md` file is the cross-platform skill that works with Claude Code, Codex CLI, Gemini CLI, and any Agent Skills-compatible tool. The `.claude-plugin/` directories are Claude Code-specific metadata for the plugin marketplace.\n\n---\n\n## Pricing\n\nMachFive uses a credit-based model (1 credit = 1 lead processed):\n\n| Plan | Credits/Month |\n|------|--------------|\n| Free | 100 |\n| Starter | 2,000 |\n| Growth | 5,000 |\n| Enterprise | Custom |\n\nThe skill itself is free. Credits are consumed by the MachFive platform when generating emails.\n\n---\n\n## License\n\nMIT — see [LICENSE](./LICENSE) for details.\n\n---\n\n## About MachFive\n\n[MachFive](https://machfive.io) is an AI-powered cold email generation platform. It researches prospects and crafts unique, personalized outreach — not templates. Built for founders, sales teams, and growth operators who want to scale personalized outreach without sacrificing quality.\n\n- **Website:** [machfive.io](https://machfive.io)\n- **App:** [app.machfive.io](https://app.machfive.io)\n- **Support:** [support@machfive.io](mailto:support@machfive.io)\n- **MCP Server:** [github.com/Bluecraft-AI/machfive-mcp](https://github.com/Bluecraft-AI/machfive-mcp)\n",
  "bytes": 6866,
  "sha": "d767353e0a5c029271fad22e011e07f0ac0a12431134965ae5607839aa378497",
  "repo_slug": "bluecraft-ai/machfive-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_bluecraft_ai_machfive_skills_machfive_co_44541ff6/readme"
}