Agent Skills

astro-doctor ships three agent skill files — structured Markdown documents that give AI coding assistants (Claude, Cursor, GitHub Copilot Workspace) the context they need to write correct Astro code and fix diagnostics automatically.

Install

astro-doctor install

This copies the skill files to .agents/skills/ in your project root. Commit this folder so every contributor (and their AI tool) benefits.

Skills included

.agents/skills/astro-rules/SKILL.md

Documents all 14 rules with before/after code examples. When your agent references this skill, it knows exactly what patterns to avoid and what to write instead.

Use cases:

• Ask your agent to fix all astro-doctor warnings in a file
• Ask your agent to review a PR for Astro best-practice violations
• Have your agent generate Astro components that pass all rules from the start

.agents/skills/astro-performance/SKILL.md

Deep context on Astro performance patterns: islands architecture, image optimization with astro:assets, View Transitions, Server Islands, and hydration strategies.

Use cases:

• Ask your agent to audit a page for performance anti-patterns
• Have your agent refactor a component to use the optimal hydration strategy
• Generate high-performance Astro pages from scratch

.agents/skills/add-rule/SKILL.md

A step-by-step TDD workflow for contributing new rules to @santi020k/eslint-plugin-astro-doctor. Includes the AST node types to target, test patterns, and the PR checklist.

Use cases:

• Ask your agent to scaffold a new ESLint rule for Astro
• Have your agent write tests for a proposed rule
• Accelerate open-source contributions with an agent that knows the architecture

Using with Claude

In Claude Code or Cowork mode, you can reference a skill directly:

# In your CLAUDE.md or agent context:
Skills: .agents/skills/astro-rules/SKILL.md

# Or tell Claude:
"Use the astro-rules skill to fix all warnings in src/components/"
       
  

Using with Cursor

Add the skills directory to your .cursor/rules or reference skill files in your system prompt:

# .cursor/rules
@.agents/skills/astro-rules/SKILL.md
@.agents/skills/astro-performance/SKILL.md
       
  

Manual installation

If you prefer to copy skill files manually, they are available in the repository .