Does it require a specific file to work?

Yes, it utilizes your project's docs/ARCHITECTURE.md to identify what constitutes a violation and how to correctly refactor the code.

Does it handle TypeScript and Image optimization?

Yes, it includes rules for correcting 'any' types and automatically replacing raw img tags with the optimized astro:assets Image component.

Can I target specific parts of my application?

Yes, you can provide a specific module or directory as an argument to limit the scope of the architectural review and automated fixing.

How does it ensure the fixes don't break the application?

The skill automatically runs 'npx astro check', 'npx astro build', and 'vitest' after each fix to validate that the code remains functional and type-safe.

What kind of violations does this skill fix?

It addresses a range of issues from critical security risks like hardcoded secrets to performance bottlenecks like unnecessary client-side hydration and architectural misalignments.

Astro Architecture Linter & Fixer

Name: Astro Architecture Linter & Fixer
Author: HerbertJulio

byHerbertJulio

•

Security & Testing

Automatically identifies and repairs architectural violations in Astro projects to ensure security, performance, and code quality.

This skill acts as an automated architect for Astro applications, scanning specific modules against your project's defined standards in docs/ARCHITECTURE.md. It prioritizes critical fixes such as sanitizing HTML and securing hardcoded secrets, while also optimizing performance by converting islands to zero-JS components and refactoring hydration directives. By moving error handling and data fetching to the page frontmatter, it enforces a clean separation of concerns and validates every change through integrated build and test cycles.

Key Features

01Critical security patching for unsanitized HTML and exposed environment secrets

02Service layer refactoring to move data fetching and error handling to frontmatter

0310 GitHub stars

04Automated validation using Astro check, production builds, and Vitest suites

05Automated detection of architectural violations via ARCHITECTURE.md scanning

06Performance optimization of hydration directives and Astro island components

Use Cases

01Pre-deployment security and performance audits of complex frontend components

02Standardizing service and adapter patterns across large-scale Astro codebases

03Modernizing legacy Astro modules to follow current project architecture standards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add herbertjulio/specialist-agent review-fix-violations

For use in Claude.ai and ChatGPT

Key Features

01Critical security patching for unsanitized HTML and exposed environment secrets

02Service layer refactoring to move data fetching and error handling to frontmatter

0310 GitHub stars

04Automated validation using Astro check, production builds, and Vitest suites

05Automated detection of architectural violations via ARCHITECTURE.md scanning

06Performance optimization of hydration directives and Astro island components

Use Cases

01Pre-deployment security and performance audits of complex frontend components

02Standardizing service and adapter patterns across large-scale Astro codebases

03Modernizing legacy Astro modules to follow current project architecture standards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add herbertjulio/specialist-agent review-fix-violations

For use in Claude.ai and ChatGPT