agentleFS
aidvggaidvgg/operator-os/skills/product-proof-saas/SKILL.md

product-proof-saas

Skill4 starsChanged 24 days agoMITView on GitHub

Create or redesign SaaS and AI product landing pages where a real workflow, interface, or deterministic demo is the central proof. Use for pale atmospheric shells, product UI in the hero, prompt-to-output stories, audience tabs, compact feature modules, honest pricing comparisons, and FAQ handoffs.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

17 rules. About 0 are common, 16 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈16

    Distinctive · estimate

    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:

    Put a real, deterministic, or clearly labeled sample workflow in the hero.

    line 13
  2. Distinctive:

    Keep pricing limits and objections in one continuous decision path.

    line 16
  3. Distinctive:

    Use white-to-pale-blue surfaces, near-black text, soft gray grid lines, and one cool signal color.

    line 22
  4. Distinctive:

    Use 12-column product grids, 12–16px radii, thin borders, and honest UI screenshots.

    line 24
  5. Distinctive:

    Keep product panels denser than the marketing copy around them.

    line 25
  6. Distinctive:

    Use black primary actions and reserve the signal color for active state, progress, selection, and focus.

    line 26
  7. Distinctive:

    Avoid decorative AI particles, constant floating, and vague glowing orbs.

    line 27
  8. Very specific:

    Use real application state when available.

    line 45
  9. Distinctive:

    Keep the workflow understandable when JavaScript or animation is unavailable.

    line 49
  10. Distinctive:

    Use semantic comparison tables or lists with aligned shared features.

    line 53
  11. Distinctive:

    Keep cadence, plan selection, CTA loading, disabled, error, and recovery states in place.

    line 55
  12. Distinctive:

    Use 160–220ms for control feedback and 420–700ms for interface state changes.

    line 61
  13. Distinctive:

    Keep cloud or background drift slow, optional, and offscreen-paused.

    line 63
  14. Distinctive:

    Avoid fake typing speed, perpetual floating cards, and decorative generation loops.

    line 64
  15. Distinctive:

    Test keyboard editing, submit, cancel, retry, copy, and comparison controls.

    line 69
  16. Distinctive:

    Verify focus, contrast, 200% zoom, mobile wrapping, history, and reduced motion.

    line 72
  17. Distinctive:

    Remove invented customers, outcomes, security claims, availability, or performance metrics.

    line 73

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

Product Proof SaaS

Show the product mechanism before making broad claims. Make the interface the evidence, not decoration.

Establish the Story

  1. Name the user friction in one sentence.
  2. Put a real, deterministic, or clearly labeled sample workflow in the hero.
  3. Explain the mechanism as input, processing, draft, edit, approval, and publish states.
  4. Organize features around user outcomes and audiences.
  5. Keep pricing limits and objections in one continuous decision path.

Replace source brands, outputs, customers, metrics, prices, screenshots, and claims. Never fake generation speed or output quality.

Build the Visual System

  • Use white-to-pale-blue surfaces, near-black text, soft gray grid lines, and one cool signal color.
  • Pair a high-x-height grotesk with compact mono labels.
  • Use 12-column product grids, 12–16px radii, thin borders, and honest UI screenshots.
  • Keep product panels denser than the marketing copy around them.
  • Use black primary actions and reserve the signal color for active state, progress, selection, and focus.
  • Avoid decorative AI particles, constant floating, and vague glowing orbs.

Compose the Page

  • Header: keep product routes compact and the primary trial or demo action obvious.
  • Hero: pair the value proposition with a product stage that demonstrates one complete outcome.
  • Friction proof: show a before/after, time breakdown, or concrete workflow constraint.
  • Feature modules: use small icons and focused copy around real capabilities.
  • Workflow: explain state changes and human control, not a magical one-click promise.
  • Audience tabs: preserve content in the DOM and deep-link when useful.
  • Proof: use verified examples, customer evidence, or clearly labeled samples.
  • Pricing: align comparable limits, usage units, and footnotes.
  • FAQ: deep-link ambiguous plan terms from the comparison table.
  • Footer: resolve trust, documentation, and legal routes against a pale-blue fade.

Implement the Prompt-to-Output Story

  • Model input, processing, draft, edit, approval, and publish as explicit states.
  • Use real application state when available; otherwise label the path Sample workflow.
  • Support edit, submit, cancel, retry, copy, version history, loading, quota, moderation, network, and error states.
  • Provide a deterministic replay and a text transcript.
  • Disable autoplay typing and large state motion for reduced motion.
  • Keep the workflow understandable when JavaScript or animation is unavailable.

Implement Pricing and FAQ

  • Use semantic comparison tables or lists with aligned shared features.
  • Explain usage units, limits, overages, and billing cadence in plain language.
  • Keep cadence, plan selection, CTA loading, disabled, error, and recovery states in place.
  • Connect ambiguous terms to deep-linked FAQ answers.
  • Restore the prior comparison view with browser Back.

Motion Defaults

  • Use 160–220ms for control feedback and 420–700ms for interface state changes.
  • Stagger cards by 45–70ms and animate one handoff at a time.
  • Keep cloud or background drift slow, optional, and offscreen-paused.
  • Avoid fake typing speed, perpetual floating cards, and decorative generation loops.
  • Render settled UI states immediately under reduced motion.

Validate

  • Test keyboard editing, submit, cancel, retry, copy, and comparison controls.
  • Exercise quota, moderation, network, empty, loading, and error states.
  • Confirm all outputs are real, deterministic samples, or clearly labeled demos.
  • Verify focus, contrast, 200% zoom, mobile wrapping, history, and reduced motion.
  • Remove invented customers, outcomes, security claims, availability, or performance metrics.

Avoid

  • A marketing mockup that cannot explain its own state changes.
  • Fake dashboards, fake typing, or unlabeled sample output.
  • Feature grids with no relation to the central workflow.
  • Hidden pricing limits or disconnected FAQ answers.
  • Generic AI particles, floating glass cards, and continuous motion.

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.