# authoring-skills

> Claude/Codex skill by [@vercel](https://omgskills.com/library/vercel/index.md) · 142k stars · Updated 2026-08-17

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.

Tags: blog, browser, compiler, components, hybrid, nextjs, node, react, server-rendering, ssg, static, static-site-generator, universal, vercel

## Install

```sh
git clone https://github.com/vercel/next.js /tmp/next.js && ln -s /tmp/next.js/.agents/skills/authoring-skills ~/.claude/skills/authoring-skills
```

## From README

Authoring Skills Use this skill when creating or modifying agent skills in .agents/skills/. When to Create a Skill Create a skill when content is: Too detailed for AGENTS.md (code templates, multi-step workflows, diagnostic procedures) Only relevant for specific tasks (not needed every session) Self-contained enough to load independently Keep in AGENTS.md instead when: It's a one-liner rule or guardrail every session needs It's a general-purpose gotcha any agent could hit File Structure Supported Frontmatter Fields Only use fields from this list. Unknown fields are silently ignored. Writing Descriptions The description is the primary matching surface for auto-activation. Include: What the skill covers (topic) When to use it (trigger scenario) Key file names the skill references (e.g. config-shared.ts) Keywords a user or agent might mention (e.g.

## Links

- HTML page: https://omgskills.com/library/vercel/next.js/dot-agents/skills/authoring-skills/
- GitHub: https://github.com/vercel/next.js
- Author: [@vercel](https://omgskills.com/library/vercel/index.md)

## More from this repo

- [backport-pr](https://omgskills.com/library/vercel/next.js/dot-agents/skills/backport-pr/index.md) — Backport a merged Next.js pull request from canary to a previous release branch such as next-16-2.
   - [@vercel](https://omgskills.com/library/vercel/index.md) · 142k stars
- [create-pr](https://omgskills.com/library/vercel/next.js/dot-agents/skills/create-pr/index.md) — Used to create Git branches, commits, pushes, and GitHub pull requests for Next.js.
   - [@vercel](https://omgskills.com/library/vercel/index.md) · 142k stars

## More skills by this author

- [turborepo](https://omgskills.com/library/vercel/turbo/turborepo/index.md) — Configure and troubleshoot Turborepo repositories.
   - [@vercel](https://omgskills.com/library/vercel/index.md) · 31k stars