Writing Guidelines
Review files for compliance with Writing Guidelines.
This skill is a Lemma-owned pin at .agents/skills/lemma-writing-guidelines/ (project agent skills). It is not a Lemma product skill; do not copy it into skills/. Do not install upstream writing-guidelines from vercel-labs/agent-skills into this folder: that skill name is different on purpose so npx skills add vercel-labs/agent-skills --skill writing-guidelines cannot overwrite this pin.
How It Works
- Read the pinned rules in command.md in this directory
- Read the specified files (or prompt user for files/pattern)
- Apply the whole pin (overlay plus body). There is no skip layer
- Output findings in the terse
file:lineformat
Guidelines Source
The pinned copy is the source of truth for reviews in this repo:
.agents/skills/lemma-writing-guidelines/command.md
skills-lock.json tracks this folder as a local skill so the skills CLI will not fetch GitHub and replace the pin. Optional handbook refresh (manual only):
https://raw.githubusercontent.com/vercel-labs/writing-guidelines/main/command.md
Refresh procedure: fetch that URL, keep the Lemma overlay, drop Vercel-only sections (pricing, dashboard deep links, ACME, AI Gateway catalog IDs, vercel/examples), keep this SKILL.md, then refresh skills-lock.json computedHash with the skills CLI folder hash (localeCompare file order). If a CLI reinstall deleted command.md, restore it from git.
Usage
When a user provides a file or pattern argument:
- Read command.md
- Read the specified files
- Apply the whole pin
- Output findings using the format specified in the guidelines
If no files specified, ask the user which files to review.