rayspec

Use this skill when the AI SEO agent is annotating a spec page's HTML with topic and kind attributes. Covers the AP reading layer — the structural mechanism that gives AI agents precise XPath addresses into page sections without reading the full document. Does not cover the AP pipeline layer (ap-gate, ap-gen, etc.) — spec pages are static HTML, not stateful pipeline documents.

Use this skill when the AI SEO agent is optimizing a page for discoverability by AI systems. Covers the five signals that make a page extractable and citable by Claude, ChatGPT, Perplexity, and future AI search tools — entity clarity, answer density, definition clarity, citation structure, and attribution.

Use this skill when the build agent is writing JavaScript animations for a spec page. Provides six named patterns — scroll-triggered reveals, SVG path draw, counter animation, hero title entrance, tab transitions, and typewriter — with working code and guidance on when to reach for each one.

Use this skill when the AI SEO agent needs to generate an llms.txt entry for a spec page, or when the deploy agent needs to update the site-wide llms.txt file. Documents the llms.txt standard, the entry format for robertrevans.com spec pages, and how individual page entries compose into the site-level index.

Use this skill when the discovery agent needs to produce a structured brief, or when the build agent needs to read one. Defines what a complete brief contains, all eight required sections, the artifact naming convention, and the completeness checklist discovery must pass before handing off to @blueprint.

Use this skill when the build agent is about to write any HTML for a spec page. Provides the path to The Point's llm.md component reference, the list of available mood files, the required CSS load order, and the hard rule against inventing bp- class names.