Skip to content
Back to search

offer-lab

MarketplaceWorks with Claude CodeGitHub

From a skill or an idea to a priced, tested offer with evidence caps on every score.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mavrin-xv--offer-lab/badge.svg)](/listings/mavrin-xv--offer-lab)

HTML

<a href="/listings/mavrin-xv--offer-lab"><img src="/api/listings/mavrin-xv--offer-lab/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Every script runs offline on the bundled example: Northwind Ops, an invented two-person studio selling a monthly stock-count cleanup to online shops.

python3 skills/niche-score/scripts/niche_score.py examples/data/niches.csv
| # | Niche | M | C | P | Total | Verdict |
|---|---|---|---|---|---|---|
| 1 | Stock count cleanup for online shops with 200+ SKUs | 4 | 4 | 5 | 13/15 | SHIP |
| 2 | Returns and refund tracking for apparel shops | 4 | 4 | 4 | 12/15 | SHIP |
| 3 | Bookkeeping catch-up for dental clinics | 4 | 2 | 3 | 9/15 | ITERATE |
| 4 | Chatbot for local restaurants | 3 | 4 | 2 | 9/15 | ITERATE |
| 5 | Notion workspace setup for solo creators | 2 | 3 | 3 | 8/15 | ITERATE |

Caps applied:
- Bookkeeping catch-up for dental clinics: pain 4->3: no quote in their words
python3 skills/validation-plan/scripts/validation_calc.py judge --visitors 640 --conversions 29 --go 0.05 --kill 0.02
29 of 640 converted: 4.5% (95% range 3.2% to 6.4%)
Lines: GO 5.0%, KILL 2.0%. Plan: 191 visitors.
VERDICT: UNCLEAR  (enough visitors, still between the lines; apply your pre-written rule (default: KILL))

The full run, from niche to the test verdict, with real output at each step: [examples/walkthrough.md](examples/walkthrough.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "offer-lab",
  3. "owner": {
  4. "name": "Artem Mavrin",
  5. "url": "https://github.com/mavrin-xv"
  6. },
  7. "plugins": [
  8. {
  9. "name": "offer-lab",
  10. "source": "./",
  11. "description": "Offer skills: niche score, reality check, positioning map, value stack, price test, offer page lint, validation plan.",
  12. "version": "0.1.0"
  13. }
  14. ]
  15. }
README.md · README · 151 lines
  1. ![offer-lab](assets/banner.png)
  2. # offer-lab
  3. **Turns a skill or an idea into a priced, tested offer with your AI agent: pick the niche that pays, check the idea against real evidence, find the claim no rival owns, build the stack and guarantee, set the price, lint the page and judge the test with numbers you wrote down first.**
  4. Most first offers fail before the copy. The buyer was too broad, the pain was real but nobody paid to fix it, the price was a guess, and a week of signups looked like a market.
  5. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  6. ![Works with](https://img.shields.io/badge/works%20with-Claude%20Code%20%7C%20Codex%20%7C%20any%20SKILL.md%20agent-black)
  7. ![Python](https://img.shields.io/badge/scripts-Python%203.8%2B%20stdlib-green)
  8. ![Network](https://img.shields.io/badge/network-none-lightgrey)
  9. ![Example output](assets/example.png)
  10. ```bash
  11. git clone https://github.com/mavrin-xv/offer-lab && cd offer-lab
  12. ./install.sh # or: ./install.sh --project
  13. ```
  14. <!-- install-notes:start -->
  15. Other ways in: as a Claude Code plugin, run `/plugin marketplace add mavrin-xv/offer-lab` and then `/plugin install offer-lab@offer-lab`. For Codex or another agent that reads `SKILL.md`, copy the folders under `skills/` into its skills directory. On Windows, run `install.sh` from Git Bash or WSL and type `py -3` where these docs say `python3`.
  16. <!-- install-notes:end -->
  17. Then tell your agent: `score these niches: ...` or `reality check this idea: ...` or `what should I charge for this?`
  18. ---
  19. ## What it solves
  20. | Pain | What the pack does |
  21. |---|---|
  22. | "Who should I sell to?" | `niche_score.py` scores Money, Channel and Pain with caps: no exact channel query, no quote in the buyer's words, no named spend, and the score drops. With 10+ won and lost deals, `icp_traits.py` finds the traits that separate them and tests the profile on deals it has not seen |
  23. | Friends said it was a great idea | `reality_check.py` weights paid items 5, commitments 3, compliments 0, and says GO, TEST, WAIT or KILL. TEST is the default |
  24. | Every rival says the same thing | `claim_triage.py` counts which claims are saturated, contested or white space, and which complaints buyers make about every rival, doing nothing included |
  25. | The offer feels weak, so you add bonuses | `value_equation.py` scores the four levers of the value equation, names the weakest, and blocks any objection no item answers, a guarantee with no number or window, and scarcity with no reason |
  26. | The price is a guess | `price_survey.py` reads Van Westendorp and Gabor-Granger surveys and prints the range and the revenue peak, labelled as stated, not paid |
  27. | The page is full of "we" and fake urgency | `offer_page_lint.py` blocks placeholders, unexplained scarcity, a missing price and a vague guarantee, and warns on hype words, a long hero and several calls to action |
  28. | 40 signups, so build it? | `validation_calc.py` sizes the test before it starts and judges it with a 95% interval: GO, KILL, KEEP RUNNING or UNCLEAR |
  29. ## What's inside
  30. | Skill | What it does | What to say |
  31. |---|---|---|
  32. | `offer-pipeline` | One offer card, seven gates, routes each request to the right stage | "help me make an offer", "turn my skill into a product" |
  33. | `niche-score` | Money, Channel, Pain with evidence caps; channel map, service angle, kill criteria; buyer profile from deals | "which niche should I pick", "who is my ideal customer" |
  34. | `idea-reality-check` | Evidence ladder, top 3 failure modes with tests, competition including doing nothing | "is this idea any good", "reality check this" |
  35. | `positioning-map` | Dunford's components, claim triage across rivals, 8 angle generators and a 7-point gate | "how do I stand out", "find an angle" |
  36. | `value-stack` | Value equation, stack mapped to objections, named guarantee, mechanism, honest scarcity | "make the offer", "write a guarantee" |
  37. | `price-test` | Value metric, anchor, tiers, price surveys, symptoms, price-change rules | "what should I charge", "should I raise prices" |
  38. | `offer-page` | A one-page outline from the card and a linter for the draft | "write the sales page", "check my page" |
  39. | `validation-plan` | Interviews, smoke tests, fake doors, pre-orders; lines written before the test, judged after | "how do I validate this", "did the test work" |
  40. ## Quick start
  41. Every script runs offline on the bundled example: Northwind Ops, an invented two-person studio selling a monthly stock-count cleanup to online shops.
  42. ```bash
  43. python3 skills/niche-score/scripts/niche_score.py examples/data/niches.csv
  44. ```
  45. ```
  46. | # | Niche | M | C | P | Total | Verdict |
  47. |---|---|---|---|---|---|---|
  48. | 1 | Stock count cleanup for online shops with 200+ SKUs | 4 | 4 | 5 | 13/15 | SHIP |
  49. | 2 | Returns and refund tracking for apparel shops | 4 | 4 | 4 | 12/15 | SHIP |
  50. | 3 | Bookkeeping catch-up for dental clinics | 4 | 2 | 3 | 9/15 | ITERATE |
  51. | 4 | Chatbot for local restaurants | 3 | 4 | 2 | 9/15 | ITERATE |
  52. | 5 | Notion workspace setup for solo creators | 2 | 3 | 3 | 8/15 | ITERATE |
  53. Caps applied:
  54. - Bookkeeping catch-up for dental clinics: pain 4->3: no quote in their words
  55. ```
  56. ```bash
  57. python3 skills/validation-plan/scripts/validation_calc.py judge --visitors 640 --conversions 29 --go 0.05 --kill 0.02
  58. ```
  59. ```
  60. 29 of 640 converted: 4.5% (95% range 3.2% to 6.4%)
  61. Lines: GO 5.0%, KILL 2.0%. Plan: 191 visitors.
  62. VERDICT: UNCLEAR (enough visitors, still between the lines; apply your pre-written rule (default: KILL))
  63. ```
  64. The full run, from niche to the test verdict, with real output at each step: [examples/walkthrough.md](examples/walkthrough.md).
  65. ## How it works
  66. ```
  67. offer card (one per offer)
  68. |
  69. [1] niche -> [2] reality -> [3] positioning -> [4] value stack -> [5] price -> [6] page -> [7] test
  70. SHIP? GO / TEST? white space? 0 blockers? one point? lint 0? GO?
  71. ^ ^ |
  72. +---------------+---------------- interviews and test results feed the evidence ---------------------+
  73. ```
  74. Each skill reads the offer card, does its stage, writes the result back and checks its gate. A failed gate names the
  75. line that failed and the evidence that would pass it. More in [docs/how-it-works.md](docs/how-it-works.md).
  76. ## Configure
  77. | Setting | Where | Default |
  78. |---|---|---|
  79. | Niche thresholds | `SHIP_AT`, `ITERATE_AT` near the top of `niche_score.py` | SHIP 11+, ITERATE 8 to 10, KILL under 8 |
  80. | Holdout size | `icp_traits.py --holdout` | the newest 5 won and 5 lost |
  81. | GO and KILL lines | `validation_calc.py --go --kill` | none: you set them from what the offer must earn |
  82. | Survey yes threshold | `price_survey.py gg --top-box` | 1: only a 5 of 5 counts as yes |
  83. | Output format | `--format json` on every script | markdown |
  84. Install without the script: copy the folders in `skills/` to `~/.claude/skills/` (or your agent's skills folder).
  85. ## Honest limits
  86. - The scores are your judgement. The scripts check that the judgement has evidence behind it; they do not know your market.
  87. - Survey results are stated willingness to pay. People say yes more often in a survey than at a checkout.
  88. - The niche thresholds, evidence weights and the 20% stack-cost line are this pack's defaults, not published standards.
  89. - Van Westendorp has several intersection conventions; the script uses the one Wikipedia describes, so numbers can differ from other tools.
  90. - The value equation index only compares versions of your own offer. It is not a market number.
  91. - The frameworks were read through public summaries and notes, not reproduced from the books. Read the books for the full argument.
  92. - The example shop studio, its rivals, deals, surveys and every number in them are invented.
  93. - Not tested on real surveys or real deal data, and the skills were not run end to end by a live agent session.
  94. - Tested on Windows with Git Bash and Python 3.12. macOS and Linux reports are welcome.
  95. ## Credits
  96. - Based on / inspired by April Dunford, *Obviously Awesome* (2019), via Commoncog's summary https://commoncog.com/obviously-awesome/ and Yevgeniy Brikman's notes https://www.ybrikman.com/blog/2020/01/12/obviously-awesome/ (book; summaries used for structure only)
  97. - Based on / inspired by Alex Hormozi, *$100M Offers* (2021): the value equation, the stack and guarantee types, via https://www.shortform.com/blog/alex-hormozi-guarantees/ and https://www.shortform.com/blog/starving-crowd/ (book; summaries used)
  98. - Based on / inspired by Rob Fitzpatrick, *The Mom Test* (2013), via https://www.ybrikman.com/blog/2023/03/29/the-mom-test/ (book)
  99. - Based on / inspired by the switch interview and the four forces: https://jobstobedone.org/switch-interview/ (article)
  100. - Based on / inspired by Van Westendorp's Price Sensitivity Meter: https://en.wikipedia.org/wiki/Van_Westendorp%27s_Price_Sensitivity_Meter (CC BY-SA 4.0)
  101. - Based on / inspired by the Gabor-Granger method: https://umbrex.com/resources/frameworks/pricing-frameworks/gabor-granger-method/ (article)
  102. - Based on / inspired by Madhavan Ramanujam and Georg Tacke, *Monetizing Innovation* (2016), and the wondelai skill https://github.com/wondelai/skills (MIT)
  103. - Based on / inspired by the pricing and offers skills in https://github.com/coreyhaines31/marketingskills (MIT)
  104. - Based on / inspired by the positioning-angles skill in https://github.com/boringmarketer/boring-marketing-skills (MIT)
  105. - Based on / inspired by value-based pricing guides https://www.robinwaite.com/blog/value-based-pricing and smoke-test guides https://www.koji.so/docs/smoke-test-product-validation and https://cleverx.com/blog/pre-launch-demand-testing-with-real-buyers (articles; their benchmark rates are quoted as vendor figures)
  106. - Awareness stages from Eugene Schwartz, *Breakthrough Advertising* (1966) (book)
  107. ## Contributing
  108. See [CONTRIBUTING.md](CONTRIBUTING.md). Notes for coding agents are in [AGENTS.md](AGENTS.md).
  109. <!-- author:start -->
  110. ## Author
  111. Built and maintained by [Artem Mavrin](https://github.com/mavrin-xv). This repo is one of a set of agent skill packs for marketing and operations work. Each one installs on its own; the full list is in [agent-skill-packs](https://github.com/mavrin-xv/agent-skill-packs). If a pack saved you an afternoon, a star helps other people find it.
  112. <!-- author:end -->
  113. ## License
  114. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.