Web Site Kit

Route site analyze, crawl, cinematic, or admin work.

Skill metadata

Source	Bundled (installed by default)
Path	skills/web-development/web-site-kit
Version	1.0.0
Author	VibeOS
License	MIT
Platforms	linux, macos, windows
Tags	web, pack, analyze, crawl, cinematic, admin, routing
Related skills	site-page-analyze, site-map-crawl, cinematic-web, large-admin-ia, browser-e2e, internet-starter, lighthouse-axe, page-agent, design-variant-picker

Reference: full SKILL.md

info

The following is the complete skill definition that VibeOS loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.

Web Site Kit

Thin routing pack for the web cinematic / structure track. Pick the right child skill; do not invent new core tools. Offline golden tasks live in docs/plans/golden-tasks-web.yaml.

When to Use

• User asks for page audit, site map, cinematic landing, or large admin IA
• Unclear which web skill to load — start here, then hand off
• After a redesign: crawl → diff → re-analyze key pages

Prerequisites

• Child skills installed (bundled under skills/web-development/)
• Python 3 for scripts; Node 20+ for cinematic/admin scaffolds
• Optional Lighthouse/axe: vibeos skills install official/web-development/lighthouse-axe (not bundled; listed under related_skills for routing only)

How to Run

CLI (no LLM): vibeos web doctor · analyze · seo · audit · crawl · sitemap · diff · scaffold cinematic|admin · preset.

User intent	Load skill	First command / artifact
One URL SEO/DOM report	site-page-analyze	vibeos web analyze <html|url>
Local SEO checklist score	site-page-analyze	vibeos web seo <html|page-report.json>
Multi-page architecture	site-map-crawl	vibeos web crawl --html-dir … / --seed
Live scroll-motion site	cinematic-web	vibeos web scaffold cinematic ./app
Pick design before build	design-variant-picker	3 HTML previews → lock tokens/DESIGN.md
Large admin / CMS shell	large-admin-ia	vibeos web scaffold admin ./admin (--with-api / --with-convex / --with-page-agent)
Lighthouse / axe scores	optional lighthouse-axe	vibeos web audit --url … (--dry-run offline)
NL inside customer admin	optional page-agent	--with-page-agent stub, then skill docs — separate admin only
Click-through smoke	browser-e2e	After any scaffold is running

Not HyperFrames. Video-from-HTML → optional skill hyperframes.
Not VibeOS dashboard. Customer admin apps are separate Next trees; page-agent embeds there, never under web/src/pages.

Quick Reference

Skill	Offline tests
site-page-analyze	tests/skills/test_site_page_analyze.py
site-map-crawl	tests/skills/test_site_map_crawl.py
cinematic-web	tests/skills/test_cinematic_web.py
large-admin-ia	tests/skills/test_large_admin_ia.py

Procedure

1. Classify intent with the table above (one primary skill).
2. Run that skill’s procedure end-to-end.
3. Optional chain: map → pick ≤5 URLs → site-page-analyze each.
4. Optional chain: cinematic or admin scaffold → browser-e2e smoke.
5. Diff maps with diff_site_maps.py when comparing before/after.
6. Report paths + counts; stop at auth/CAPTCHA walls.

Pitfalls

• Do not extend web/src/pages (VibeOS ops dashboard) for customer CMS.
• Do not unbounded-crawl; default max pages is 30.
• Do not mix HyperFrames (MP4) with cinematic-web (live site).
• Zero new core tools — scripts + browser toolset only.

Verification

• Chosen child skill’s Verification section passes.
• scripts/smoke-web-site-kit.sh — doctor + fixture analyze/seo/crawl + audit dry-run + pack tests.
• scripts/run_tests.sh tests/skills/test_site_page_analyze.py tests/skills/test_site_map_crawl.py tests/skills/test_cinematic_web.py tests/skills/test_large_admin_ia.py -q is green when changing this pack.