agentleFS
jtmuller5jtmuller5/small-business-skills/skills/offer/SKILL.md

offer

Skill0 starsChanged 2 months agoMITView on GitHub

Turn a validated problem into a first version small enough to actually finish and specific enough to sell. Use when someone knows what problem they are solving and is about to start building, when scope keeps growing, or when they have been building for months with nothing shippable.

9 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use contributor and interview.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • NimbleBrainIncSkill

    contributor

    Get started contributing to NimbleBrain open source — find an integration to build, set up your environment, propose an idea, or check on your work. Use when onboarding as a contributor. Triggers include "I'm a new contributor", "what should I build", "show me open issues", "file an issue".

    Also in 3 projects that use this

  • dazuckSkill

    interview

    Interview me about a plan to flesh out requirements before implementation. Asks non-obvious questions one at a time until all ambiguities are resolved.

    Also in 3 projects that use this

The file

Show its rules and text

We split this skill into the rules it gives an agent

13 rules. 0 are common, 12 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 8 edited versions we read keep these.

  • 12

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Not the three jobs. One. Say it as: *"they hire this to ______, and they will know it worked when ______."*

    line 15
  2. Distinctive:

    If the second blank cannot be filled with something observable, the offer is not defined yet and no amount of building will fix that.

    line 18
  3. Distinctive:

    If yes, that is version one.

    line 34
  4. Distinctive:

    Before anything is automated or built, ask whether the first ten customers could be served manually.

    line 39
  5. Distinctive:

    Write the first version as something checkable:

    line 49
  6. Distinctive:

    Ask how long they think it will take, then ask what they are assuming goes right.

    line 61
  7. Distinctive:

    If it cannot be finished in about a month, cut again.

    line 65
  8. Distinctive:

    Do not leave pricing to the end.

    line 70
  9. Very specific:

    If the number needs proper work, run sell.

    line 75
  10. Distinctive:

    Do not let "while we're at it" add anything.

    line 85
  11. Distinctive:

    Do not build infrastructure for a scale that does not exist.

    line 86
  12. Distinctive:

    Do not ship something that does not do the job in order to ship on time.

    line 87
  13. Distinctive:

    Do not spend a month on the thing the customer never sees.

    line 89

“Common” is measured: kept by at least 6 in 10 of the 8 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Offer

Your job is to make the first version smaller than they want it to be, and to make sure it is the smallest thing that is worth paying for rather than the smallest thing that is easy to build. Those are different, and only the first one is useful.

Find the one job

From the validation notes, find the single job the customer is hiring this for. Not the three jobs. One. Say it as: "they hire this to ______, and they will know it worked when ______."

If the second blank cannot be filled with something observable, the offer is not defined yet and no amount of building will fix that.

Cut

List everything they think version one needs. Then sort every item into:

  • Core — without this the job is not done. Usually two or three things.
  • Expected — the customer would be surprised by its absence. Often fewer than people think, and worth checking rather than assuming.
  • Later — everything else. Say this out loud: later is not never.

Then ask the question that does the actual work:

If you could only ship the core, could you charge for it?

If yes, that is version one. If no, find out what is missing from expected, add only that, and ask again.

Do it by hand first

Before anything is automated or built, ask whether the first ten customers could be served manually. Almost always they can, and it is almost always the right move: the person learns what the product needs from doing the work, and they can charge from week one instead of month six.

Say this plainly. It is the highest-value advice in this skill and it is the advice people most want to skip, because building is more fun than serving.

Specify it

Write the first version as something checkable:

  • what the customer gives you
  • what you give back, and in what form
  • how long it takes
  • what is explicitly not included
  • what "done" looks like, from the customer's side

That last one is the specification. Everything else is detail.

Make it finishable

Ask how long they think it will take, then ask what they are assuming goes right. Set a date, and set the scope to fit the date rather than the other way round — scope is negotiable, calendars are not.

If it cannot be finished in about a month, cut again. A first version that takes a quarter is nearly always three versions that were never allowed to ship separately.

Price it enough to hurt slightly

Do not leave pricing to the end. Give a starting number now, anchored on what the customer currently spends on the alternative, including their own time. Underpricing the first version is the most common and most persistent mistake in this whole process: it is very hard to raise a price on people who already bought.

If the number needs proper work, run sell.

What to hand back

offer.md: the one job, the core / expected / later split, the specification, the date, the price, and the manual version of the process that runs until automating it is obviously worth doing.

Do not

  • Do not let "while we're at it" add anything. Write it in later and move on.
  • Do not build infrastructure for a scale that does not exist.
  • Do not ship something that does not do the job in order to ship on time. Cut scope sideways, not through the middle.
  • Do not spend a month on the thing the customer never sees.

Next

brand if it needs a name. presence if people will look for it. sell if it is ready and needs a price and a conversation.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.