agentleFS
wrg32786wrg32786/aigent-design-system/skills/aigent-business-sites/SKILL.md

aigent-business-sites

Skill4 starsChanged 3 months agoMITView on GitHub

Business-website layer for aigent-design. Use when the work is a marketing site, landing page, service or local business site, ecommerce surface, editorial or membership site, portfolio, or nonprofit site and the job needs content architecture, truthful proof, preserve-mode redesign, or a release audit, not just visual direction.

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 7 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use it alongside aigent-design when the surface has a business job: leads, trials, purchases, bookings, subscriptions, donations, or trust.

    line 14
  2. Distinctive:

    Keep the path small. A one-line copy or state fix does not need a content matrix.

    line 16
  3. Distinctive:

    Never invent testimonials, metrics, ratings, customers, logos, awards, prices, certifications, capabilities, affiliations, or legal claims.

    line 30
  4. Very specific:

    Use the strongest real proof available and never fake a higher rung.

    line 32
  5. Distinctive:

    Never make a control look functional when it is not.

    line 33
  6. Distinctive:

    Run the interchangeability test: swap in an unrelated company from the same category.

    line 48
  7. Distinctive:

    Do not ban a font, punctuation mark, icon set, or palette just because some skill said so.

    line 51
  8. Distinctive:

    Taste, Resolve, Vision: run them as usual. They are the mechanical and visual floor.

    line 69
  9. Distinctive:

    Never claim a check ran when it did not.

    line 72

≈ “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

Aigent Business Sites

This skill adds the business side of a website to aigent-design. aigent-design still owns authority, direction, the Variance / Motion / Density controls, Taste, Resolve, and Vision. This skill owns what the page has to say, what it is allowed to claim, what a redesign must not break, and when a site is actually ready to ship.

Most of it is ported from Ultra Web Design. See NOTICE.md.

When to use it

Use it alongside aigent-design when the surface has a business job: leads, trials, purchases, bookings, subscriptions, donations, or trust. Skip it for product UI, dashboards, decks, and pure visual experiments.

Keep the path small. A one-line copy or state fix does not need a content matrix.

TaskPathRead
tiny copy, style, or state fixread, fix, rendernothing extra
new section or route in an established brandread, surface brief, build, renderreference/business-content.md
preserve-mode redesignread, preservation inventory, modernize, renderreference/preserve-redesign.md
full redesign or greenfield sitefull aigent-design loop plus this skillall three references
audit only, no editsread, audit, reportreference/release-audit.md

Always on

Truth

  • Never invent testimonials, metrics, ratings, customers, logos, awards, prices, certifications, capabilities, affiliations, or legal claims.
  • Label every uncertain input as SUPPLIED, ASSUMED, ILLUSTRATIVE, MISSING, or PROHIBITED. Do not quietly promote an assumption to production copy.
  • Use the strongest real proof available and never fake a higher rung. The proof ladder is in reference/business-content.md.
  • Never make a control look functional when it is not. Fake product UI built from empty divs counts.

Business continuity

In any redesign, inventory routes, redirects, nav labels, forms and field names, analytics events, SEO metadata, proof, legal copy, brand marks, and existing accessibility wins before changing anything. This extends the TARGET / PRESERVE contract in aigent-design. Details in reference/preserve-redesign.md.

Page structure

  • One primary business objective and one primary CTA per surface. A secondary CTA is fine when it serves a different readiness level.
  • Organize content around visitor questions, not a default Hero, Features, Pricing, FAQ, CTA stack.
  • Important claims follow claim, mechanism, proof, implication.
  • CTA labels name the next step. Avoid Learn more when a better verb exists.

Anti-generic

  • Run the interchangeability test: swap in an unrelated company from the same category. If the page still works, the concept is too generic.
  • The page needs at least one detail that only someone who understands the product would add (the soul test).
  • Generic-pattern findings must name the harm (repetition, meaninglessness, mismatch, a real defect). "Looks AI-generated" is a symptom, not a finding.
  • Do not ban a font, punctuation mark, icon set, or palette just because some skill said so. Fail it when it is unearned, repeated, misleading, or indistinguishable from the category default.

Working templates

Copy into the target project only what the work needs, then delete unused fields. These are scratch files, not ceremony.

  • templates/SURFACE-BRIEF.md one route: job, visitor state, first viewport, proof, states, analytics
  • templates/CONTENT-MATRIX.md every section mapped to a visitor question, proof, and truth status
  • templates/PRESERVATION-INVENTORY.md what a redesign keeps, evolves, or replaces
  • templates/QA-REPORT.md design jury, technical audit, findings, context matrix

Visual direction, tokens, and DESIGN.md stay with aigent-design and .aigent/design-direction.md. Do not create a second design contract.

How it plugs into the aigent loop

  1. Shape (aigent-design/reference/shape.md): add the business objective, visitor awareness state, objections, and proof inventory from reference/business-content.md.
  2. Direction: pick a page grammar and hero form that fit the business type. Do a quick category-rut list before directions so they avoid the default.
  3. Build: real content or labeled placeholders only.
  4. Taste, Resolve, Vision: run them as usual. They are the mechanical and visual floor.
  5. Release: then run the business release checks in reference/release-audit.md. Report what was observed and what was not checked.

Never claim a check ran when it did not.

Evals

evals/ has six output cases and twenty trigger queries (ten should fire, ten near misses). See evals/README.md.

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.