Agent Skills Library

This repo ships a small set of agent skills under .claude/skills/ so contributors (human or AI) know how to work in the codebase without re-learning conventions every time.

Each skill is a folder with a SKILL.md file that explains when to use it and what to check. Use these skills to keep tone, structure, and engineering workflows consistent.

For page scaffolding, pair the skills below with the golden templates in /labs/page-templates/.

How to use the skills

• Pick the skill that matches the task (writing, review, UI changes, or DevOps).
• Read the SKILL.md file before making changes.
• Follow the workflow and references listed in the skill.
• Update the skill when the workflow changes or new tooling is added.

Available skills

Repo orientation

Use for onboarding and to understand repo structure, commands, and where to log feedback.

Location: .claude/skills/repo-orientation/

Content authoring

Use when drafting or migrating content under src/content/{docs,learn,guides}.

Location: .claude/skills/content-authoring/

Migration planning

Use when auditing legacy portals, creating migration plans, or building redirect rules.

Location: .claude/skills/migration-planning/

Docs style review

Use when reviewing or editing docs content to match the style guide and approved shortcodes.

Location: .claude/skills/docs-style-review/

Site engineering

Use when modifying layouts, components, or SDS-aligned CSS.

Location: .claude/skills/site-engineering/

Contract + pipeline verification

Use after architecture-affecting changes to verify route/locale/access contracts and generated-data boundaries remain consistent.

Location: .claude/skills/contract-pipeline-verification/

DevOps workflow

Use when touching build scripts, indexing jobs, or deployment config.

Location: .claude/skills/devops-workflow/

Workflow

Use when preparing commits, opening PRs, or validating PR readiness.

Location: .claude/skills/workflow/

Refactoring

Use when auditing architecture drift, improving consistency, or generating prioritized cleanup lists.

Location: .claude/skills/refactoring/

Creating new skills

When a workflow becomes repetitive or fragile, add a new skill. Use the skill-creator skill to scaffold and validate it.