The Website Specification
This story unveils "The Website Specification," a comprehensive, platform-agnostic guide detailing essential technical features for any decent website. It's gaining traction on HN for its ambition to standardize web best practices, ranging from basic HTML to AI agent readiness. The project's open-source nature and emphasis on established standards appeal to developers seeking a unified reference for web development excellence.
The Lowdown
The Website Specification is an ambitious project aiming to define the fundamental technical features that constitute a "good" website. Conceived as a platform-agnostic, human and agent-readable guide, it compiles widely accepted web standards into a single, comprehensive resource, moving beyond mere opinion to provide actionable, verifiable guidelines.
- Comprehensive Coverage: The specification is structured into ten key categories, including foundational HTML, SEO, accessibility (WCAG), security, performance (Core Web Vitals), privacy, internationalization, and even "agent readiness" for AI crawlers.
- Standards-Based: Each guideline is meticulously linked back to authoritative sources such as WHATWG, W3C, IETF RFCs, WCAG, and MDN, ensuring that recommendations are rooted in established web standards, not subjective preferences.
- Platform Agnostic: It emphasizes that the specification applies universally, regardless of the underlying technology stack, from traditional CMS platforms like WordPress to modern frameworks like Next.js or plain HTML.
- Open and Collaborative: The project is "built in the open," encouraging community contributions via GitHub pull requests, with all sources and credits transparently provided.
- AI Integration: Uniquely, the entire specification is accessible as an open Model Context Protocol (MCP) server, alongside a published Agent Skill, allowing compatible AI agents to directly query and utilize the guidelines, with per-page Markdown also available.
- Practical Usage: Users are encouraged to audit their sites against a provided checklist, delve into specific items to learn their importance and implementation, and contribute improvements to the specification itself.
By consolidating best practices and leveraging modern AI agent capabilities, "The Website Specification" positions itself as a vital resource for developers striving to build robust, accessible, secure, and performant websites in an increasingly complex digital landscape.