Skip to main content

What Is SKILLS.md?

A SKILLS.md file is a machine-readable definition of:

  • Architectural standards
  • Development workflows
  • Naming conventions
  • Engineering constraints
  • Organizational knowledge

Think of it as a contract between architects and AI.

Without skills:

With skills:

info

The AI follows architecture instead of inventing its own.

Mini Exercise​

Write a five-line SKILLS.md draft for a login feature.

Include rules for:

  • naming
  • component structure
  • state management
  • testing

Example​

For login features:
1. Name the page LoginPage and the template LoginTemplate.
2. Keep reusable inputs and buttons as atoms or molecules.
3. Store authentication state in a dedicated AuthState module.
4. Validate form input before calling the API.
5. Create tests for the state and page behavior.