How to create and maintain agent skills in .agents/skills/. Use when creating a new SKILL.md, writing skill descriptions, choosing frontmatter fields, or deciding what content belongs in a skill vs AGENTS.md. Covers the supported spec fields, description writing, naming conventions, and the relationship between always-loaded AGENTS.md and on-demand skills.
Install
npx skills add vercel/next.js --skill authoring-skillsnpx skills add vercel/next.js --skill authoring-skills -a claude-code -gnpx skills add vercel/next.js --skill authoring-skills -a codex -ggemini skills install https://github.com/vercel/next.js.git --path .agents/skills/authoring-skillsgh skill install vercel/next.js authoring-skillsgit clone --depth 1 https://github.com/vercel/next.js /tmp/vercel__next.js
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/vercel__next.js/.agents/skills/authoring-skills ~/.claude/skills/authoring-skills # Claude Code
cp -R /tmp/vercel__next.js/.agents/skills/authoring-skills ~/.agents/skills/authoring-skills # Codex, Cursor, Gemini CLI, Copilot, OpenCode