# Skill Layout

> Use when adding/modifying agent skills in this repo, or when figuring out how skills are organized here.

- Skill: `aminedjeghri/skill-layout` (Agent Skill)
- Install (CLI): `npx skillmds@latest add aminedjeghri/skill-layout`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aminedjeghri/skill-layout/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: aminedjeghri (https://skillmd.com/u/aminedjeghri)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aminedjeghri/skill-layout

---


# Skill layout in this repo

- **Canonical skills:** `.claude/skills/<name>/SKILL.md` — edit here (Claude Code reads this natively)
- **Cross-agent view:** `.agents/skills/<name>` are git symlinks → `../../.claude/skills/<name>`
  (Hermes, Codex, OpenCode and the skills CLI read `.agents/skills`)
- **Add a skill:** create `.claude/skills/<name>/SKILL.md`, then run `make skills-link`
- **Verify:** `make skills-check`
- Never edit through a symlink — always edit the canonical file
- Windows note: git symlinks need `core.symlinks=true` on native Windows checkouts