project-guides

What problem does it solve?

This Skill solves the problem of inconsistent, incomplete, or poorly structured web platform guidance that causes AI coding assistants to generate legacy, incorrect, or non-performant implementation code. It standardizes the end-to-end authoring and review process for guide.md files, which are the sole source of truth for real-world coding agents retrieving modern web guidance.

Core Features & Use Cases

• Standardized Guide Authoring: Enforces strict formatting, content, and self-containment rules for guide.md files to ensure they are fully actionable for AI agents without external references.
• Mandatory Compatibility & Fallback Requirements: Requires all guides to include up-to-date browser Baseline status, fallback strategies for older browsers, and restrictions on unsafe polyfills to ensure broad, safe compatibility.
• Eval Infrastructure Guidelines: Provides clear rules for creating supporting eval infrastructure (demo.html, expectations.md, grader.ts) to validate that guides produce correct agent implementations.
• Use Case: A team building a modern web guidance library for AI coding assistants uses this Skill to ensure all guides follow consistent standards, so agents reliably generate modern, performant, and accessible implementation code for web platform features.

Quick Start

Use the project-guides skill to author or review a new guide.md file for a modern web platform feature, following all mandatory formatting, content, and fallback requirements.