{"id":51902047,"url":"https://github.com/concaption/cold-md","last_synced_at":"2026-07-26T16:31:01.124Z","repository":{"id":352067707,"uuid":"1213707823","full_name":"concaption/cold-md","owner":"concaption","description":"One markdown file that tells an AI agent how to do your cold outreach. Open spec + Claude Code skill.","archived":false,"fork":false,"pushed_at":"2026-04-29T01:08:25.000Z","size":8767,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-29T02:29:48.837Z","etag":null,"topics":["ai-agents","claude-code","cold-email","cold-outreach","foxreach","markdown","outbound","sales","spec"],"latest_commit_sha":null,"homepage":"https://cold.md","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/concaption.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-17T17:13:48.000Z","updated_at":"2026-04-29T01:08:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/concaption/cold-md","commit_stats":null,"previous_names":["concaption/cold-md"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/concaption/cold-md","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/concaption%2Fcold-md","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/concaption%2Fcold-md/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/concaption%2Fcold-md/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/concaption%2Fcold-md/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/concaption","download_url":"https://codeload.github.com/concaption/cold-md/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/concaption%2Fcold-md/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35920983,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-26T02:00:06.503Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","claude-code","cold-email","cold-outreach","foxreach","markdown","outbound","sales","spec"],"created_at":"2026-07-26T16:31:00.506Z","updated_at":"2026-07-26T16:31:01.115Z","avatar_url":"https://github.com/concaption.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- Updated: 2026-04-17 --\u003e\n\n![cold.md](assets/cover.png)\n\n# cold.md - The Claude Code plugin that runs your cold outreach\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Spec: CC-BY-4.0](https://img.shields.io/badge/Spec-CC--BY--4.0-blue.svg)](https://creativecommons.org/licenses/by/4.0/)\n[![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-C2410C)](https://claude.ai/claude-code)\n[![Site](https://img.shields.io/badge/cold.md-live-1a1512)](https://cold.md)\n\nSix skills, one `/cold` command. ICP builder, lead sourcing, drafter, sender, reply triage, reporter. Reads a portable `cold.md` spec from your repo. Backed by [FoxReach](https://foxreach.io) for sending.\n\n**Not another cold-email skill.** The other Claude Code cold-email skills on the market draft messages. That's step 3 of a six-step loop. `cold.md` is the whole loop.\n\n## Install in 30 seconds\n\n```bash\ncurl -fsSL https://cold.md/install | bash\n```\n\nThat installs the full `cold-md` plugin (all 6 skills, the `/cold` router) to `~/.claude/plugins/cold-md/`. Pass `--skills-only` to skip the plugin and get the open skills only. Pass `--scaffold` to also drop `cold.md` + `icp.md` templates in your current repo.\n\n## The loop\n\n```bash\n/cold icp https://your-site.com       # Step 1: who - builds icp.md\n/cold leads --count 100                 # Step 2: prospects - writes leads.csv (v0.2)\n/cold draft Jane, CEO at Acme           # Step 3: draft from cold.md\n/cold send ./leads.csv                  # Step 4: queue via FoxReach (v0.2)\n/cold triage                            # Step 5: sort replies, draft responses (v0.2)\n/cold report weekly                     # Step 6: digest on cron\n```\n\n## The six skills\n\n| # | Skill | Purpose | v0 Status | Requires |\n|---|---|---|---|---|\n| 01 | [`cold-icp`](skills/cold-icp/) | Build `icp.md` from a URL or Q\u0026A | **Live** | Nothing |\n| 02 | [`cold-leads`](skills/cold-leads/) | Source leads matching `icp.md` into `leads.csv` | Stub (v0.2) | FoxReach API key |\n| 03 | [`cold-draft`](skills/cold-draft/) | Draft openers, bumps, breakups from `cold.md` | **Live** | Nothing |\n| 04 | [`cold-send`](skills/cold-send/) | Queue campaign via FoxReach with safety checks | Stub (v0.2) | FoxReach API key |\n| 05 | [`cold-triage`](skills/cold-triage/) | Sort inbound replies, draft responses | Stub (v0.2) | FoxReach API key |\n| 06 | [`cold-report`](skills/cold-report/) | Daily or weekly digest, cron-ready | **Live** | FoxReach API key |\n\nStubs are intentional. They define a stable contract so you can wire your own tooling today; the full implementation ships in v0.2.\n\n## The two files\n\n```\n./cold.md   # voice, sequence, proof, banned - what the skills write\n./icp.md    # audience, disqualifiers, qualification checklist - who they target\n```\n\nBoth live at your repo root. Both are plain markdown. Both are portable across vendors.\n\n### `cold.md` at a glance\n\n```\n# My Product - cold.md\n\n## Identity    - who's sending\n## Audience    - ICP + disqualifiers\n## Value       - the offer, in one sentence\n## Voice       - dos and don'ts, obeyed verbatim\n## Proof       - facts the agent may cite\n## Sequence    - opener, bump, breakup slots\n## Objections  - preferred replies to pushbacks\n## Banned      - phrases that never appear\n```\n\nSpec: [`spec/cold-md-v0.md`](spec/cold-md-v0.md). Also published at [cold.md](https://cold.md).\n\n## Why a suite, not a skill\n\n| Single cold-email skill | cold.md suite |\n|---|---|\n| Writes copy when asked | Owns every step: ICP → leads → draft → send → triage → report |\n| No ICP, no sending, no triage | All six, each callable independently |\n| Config lives in the prompt | Config lives in `cold.md` + `icp.md` in your repo |\n| Every project restarts from scratch | Files travel with your team |\n| Vendor-locked to whichever LLM | Vendor-neutral spec. Swap backends without rewriting. |\n\n## Configure FoxReach\n\nThe skills that send, triage, or report need an API key:\n\n```bash\nexport FOXREACH_API_KEY=fr_...\n```\n\nFree tier: https://foxreach.io/signup.\n\n## Automated reporting\n\n`cold-report` is designed to run unattended. Two recommended paths:\n\n**(a) FoxReach dashboard** - schedule digest in Notifications. Posts to Slack/email. Zero local setup.\n\n**(b) Claude Code `/schedule` skill** - for power users who keep Claude Code running:\n```bash\n/schedule \"0 9 * * 1\" \"cold report weekly\"\n```\n\n## Repository layout\n\n```\nspec/             The cold.md file spec. Versioned.\nskills/           The six standalone skills (each installable solo).\nplugin/cold-md/   The Claude Code plugin that bundles all six + the /cold router.\nexamples/         Sample cold.md files (minimal starter + the real FoxReach one).\nsite/             Next.js site at cold.md.\nassets/           Cover image, brand.\nmemory/           Architecture, decisions, changelog.\n```\n\n## Contributing\n\nThe spec is the product. Every change to `spec/` is a commercial decision - open an issue first. New skills, examples, docs, and implementations: PRs welcome. Especially interested in other backend implementations (Smartlead plugin? Mailcoach plugin? PR it).\n\n## License\n\n- **Code** (skills, plugin, site): [MIT](LICENSE)\n- **Spec** (`spec/*`): [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/)\n\n## Star history\n\n[![Star History Chart](https://api.star-history.com/svg?repos=concaption/cold-md\u0026type=Date)](https://star-history.com/#concaption/cold-md\u0026Date)\n\n## Built by\n\nThe team at [FoxReach](https://foxreach.io). Cold email infrastructure that doesn't torch your domain.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconcaption%2Fcold-md","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconcaption%2Fcold-md","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconcaption%2Fcold-md/lists"}