# SKILLS.md - Global Skill Index

## Purpose

This file routes AI agents to the correct skill files.

Agents should not load every skill for every task. Load only what is needed.

## Always Apply

- Clear reasoning
- Small steps
- Secure defaults
- Testable outputs
- Maintainable structure
- Explicit contracts for inputs, outputs, invariants, and failure modes
- Product Owner alignment
- Agile delivery
- Concise documentation

## Skill Routing

| Need | Load |
|---|---|
| Agile delivery | `./skills/agile.md` |
| Scrum events | `./skills/scrum.md` |
| Architecture | `./skills/architecture.md` |
| Design by contract | `./skills/design-by-contract.md` |
| Clean code | `./skills/clean-code.md` |
| Testing | `./skills/testing.md` |
| Security | `./skills/security.md` |
| Database design | `./skills/database-design.md` |
| CI/CD | `./skills/ci-cd.md` |
| Documentation | `./skills/documentation.md` |
| Code review | `./skills/code-review.md` |
| Markdown agent systems | `./skills/markdown-agent-systems.md` |
| Self-evolution | `./skills/self-evolution.md` |

## Skill Loading Rule

For each task, state which skills are being applied.

Example:

```text
Applying:
- agile.md
- architecture.md
- testing.md
```

## Skill Improvement Rule

When a skill file misses something important, create an improvement proposal instead of silently changing standards.

Project-specific techniques belong in `./.ai/project/` unless they are proven reusable across projects.

For reusable skill changes, follow:

- `./.ai/evolution/evolution-rules.md`
- `./.ai/evolution/improvement-proposal-template.md`