agentleFS
pabloirracionalpabloirracional/claude-skills/skills/scaffolding-landing-pages/SKILL.md

scaffolding-landing-pages

Skill0 starsChanged 4 months agoMITView on GitHub

Scaffolds responsive landing pages and small web projects - semantic HTML, clean CSS, vanilla JS for forms and interactions, and a deployment-ready file structure. Make sure to use this skill whenever the user wants a landing page, one-pager, marketing site, or basic web project built quickly, or mentions an HTML/CSS starter, hero section, contact form, or "web dev from scratch" - even if they don't explicitly ask for a "landing page".

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 5 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask (or infer) what the page needs: hero, features, pricing, testimonials, FAQ, contact form, footer.

    line 26
  2. Distinctive:

    Default for a single-page site (no framework needed unless the user asks for React/Vue):

    line 30
  3. Distinctive:

    Don't reach for a build tool or framework unless the user needs multiple routes, a CMS, or component reuse across pages - a single-page …

    line 39
  4. Very specific:

    Use real semantic elements, not div soup: <header>, <nav>, <main>, <section>, <footer>.

    line 43
  5. Distinctive:

    Avoid pulling in a CSS framework (Bootstrap/Tailwind CDN) unless the user asks - a hand-written stylesheet for a single page is usually …

    line 49
  6. Distinctive:

    Use vanilla JS for: mobile nav toggle, smooth scroll to anchors, form validation/submission, FAQ accordion.

    line 53
  7. Very specific:

    All images have alt text

    line 60
  8. Very specific:

    No render-blocking large images - suggest loading="lazy" for below-the-fold images

    line 63
  9. Very specific:

    If the user wants this deployed, mention Netlify/Vercel/GitHub Pages as zero-config static hosts - don't assume which one without asking.

    line 67

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 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

Scaffolding landing pages

Builds a responsive, dependency-light landing page: semantic HTML, clean CSS, and vanilla JS where interactivity is needed.

Workflow

Copy this checklist and track progress:

Progress:
- [ ] Step 1: Clarify sections and goal
- [ ] Step 2: Set up file structure
- [ ] Step 3: Build semantic HTML
- [ ] Step 4: Style responsively
- [ ] Step 5: Add interactions
- [ ] Step 6: Check accessibility and performance

Step 1: Clarify sections and goal

Ask (or infer) what the page needs: hero, features, pricing, testimonials, FAQ, contact form, footer. Confirm the primary call-to-action - a landing page should have exactly one main conversion goal.

Step 2: Set up file structure

Default for a single-page site (no framework needed unless the user asks for React/Vue):

project/
├── index.html
├── styles.css
└── script.js

Don't reach for a build tool or framework unless the user needs multiple routes, a CMS, or component reuse across pages - a single-page marketing site rarely does.

Step 3: Build semantic HTML

Use real semantic elements, not div soup: <header>, <nav>, <main>, <section>, <footer>. Every section needs a heading (h2) even if visually hidden, for accessibility and SEO. Include meta viewport and a real <title>/meta description.

Step 4: Style responsively

Mobile-first: write base styles for small screens, add @media (min-width: ...) for larger. Use CSS Grid/Flexbox for layout, CSS custom properties for the color palette and spacing scale so the whole page can be re-themed by editing a handful of variables at the top of the file.

Avoid pulling in a CSS framework (Bootstrap/Tailwind CDN) unless the user asks - a hand-written stylesheet for a single page is usually smaller and easier to customize.

Step 5: Add interactions

Use vanilla JS for: mobile nav toggle, smooth scroll to anchors, form validation/submission, FAQ accordion. Keep it framework-free unless the page's complexity genuinely requires state management.

For contact forms with no backend, wire to a form endpoint service (e.g. Formspree-style POST) or clearly mark where the user needs to plug in their own backend - never fabricate a working submission endpoint.

Step 6: Check accessibility and performance

Before delivering, verify:

  • All images have alt text
  • Color contrast is readable (don't rely on light gray text on white)
  • Interactive elements are keyboard-reachable (real <button>/<a>, not <div onclick>)
  • No render-blocking large images - suggest loading="lazy" for below-the-fold images

Notes

  • If the user wants this deployed, mention Netlify/Vercel/GitHub Pages as zero-config static hosts - don't assume which one without asking.
  • For anything beyond a single page (multiple routes, a blog, a CMS-backed site), recommend a framework (Next.js/Astro) instead of hand-rolling more HTML files.

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.