.claude/skills/sync-website/SKILL.md
Sync the yaah marketing website (website/index.html) with the current project state — features, CLI commands, skills, agents, hooks, and installation instructions. Use this skill whenever the user adds, removes, or changes a feature, CLI command, hook, skill, agent, MCP server, or LSP provider AND the website should reflect that change. Also use when the user explicitly asks to update, sync, or refresh the website, or says things like 'update the site', 'keep the website current', 'reflect this on the website', or 'the website is out of date'.
npx skillsauth add dirien/yet-another-agent-harness sync-websiteInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Keep website/index.html in sync with the yaah project's actual capabilities.
The website is a static single-page site in website/. It auto-deploys to GitHub Pages on push to main (via .github/workflows/deploy-pages.yaml). When features change in the Go code but the website isn't updated, users see stale information.
Each website section has a canonical source of truth. Read the source first, then update the HTML.
| Website section | HTML landmark | Source of truth |
|---|---|---|
| Hero stats (4 numbers) | .hero-stats .stat-number | Count from registries below |
| Features grid | #features .features-grid | README.md features + pkg/ packages |
| How It Works | #how-it-works | README.md quick-start |
| Multi-Agent table | #agents .table-wrapper | pkg/generator/ — one file per agent |
| Install methods | #install .install-grid | README.md install section |
| CLI Reference | #cli .cli-grid | cmd/yaah/main.go + internal/cli/ cobra commands |
| Stat | How to count |
|---|---|
| Agents | Number of generators in pkg/generator/ (claude, opencode, codex, copilot) |
| Skills | ls .claude/skills/ — count directories that contain a SKILL.md |
| Hooks | Count distinct handler types in pkg/hooks/handlers/ |
| Sub-Agents | ls .claude/agents/ — count .md files |
Audit — Read the source of truth for the section that changed. Read website/index.html to see what's currently shown.
Diff — Identify what's new, removed, or changed.
Edit — Update website/index.html with the Edit tool. Match existing HTML patterns exactly:
<div class="feature-card"> with <h3> and <p><div class="cli-item"> with <code> for command, <p> for description<div class="stat"> with <span class="stat-number"> and <span class="stat-label"><div class="install-card"> with code blocksVerify — Count items in the edited HTML to confirm they match the codebase.
website/**).tools
Implements advanced TypeScript type systems, creates custom type guards, utility types, and branded types, and configures tRPC for end-to-end type safety. Use when building TypeScript applications requiring advanced generics, conditional or mapped types, discriminated unions, monorepo setup, or full-stack type safety with tRPC.
development
Use when challenging ideas, plans, decisions, or proposals using structured critical reasoning. Invoke to play devil's advocate, run a pre-mortem, red team, or audit evidence and assumptions.
development
Systematic technical debt analysis across architecture, testing, documentation, and infrastructure. Investigates the codebase, scores findings by impact and effort, and generates a prioritized TECH_DEBT.md remediation plan. Delegates to specialized skills for code quality (scout) and linting (lint-fix). Use when assessing overall project health, planning cleanup sprints, or onboarding to an unfamiliar codebase.
testing
Install and configure Tailscale across platforms. Detects OS, distro, and environment (including WSL2 and containers). Verifies existing installations, performs platform-appropriate install, and guides initial connection. Use when setting up Tailscale on a new machine, onboarding a server to a tailnet, or verifying an existing install.