Agent skill
writing-skills
Use when creating or updating SKILL.md documentation - Explains how and why to create a skill.
Install this agent skill to your Project
npx add-skill https://github.com/dave1010/tools/tree/main/.agents/skills/writing-skills
SKILL.md
Skills are used for context that may be useful to a coding agent, without bloating LLM context when they are not relevant.
Skills are only worthwhile if the coding agent fails a task without the skill.
Skills live in /.agents/skills, with each skill having its own directory.
SKILL.md
Front matter
- Match the
nameto the directory name exactly. - Write the
descriptionas "Use when - " in under 30 words and third person. - Quote the description if it includes punctuation that could break YAML.
Markdown body
- Write concise instructions for the skill topic.
- Keep headings and bullet lists structured so readers can scan quickly.
Additional files
Other files, like scripts or data, may live in the directory and be referenced by the skill.
AGENTS.md
A GitHub Action automatically regenerates the skills list in AGENTS.md.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
cloudflare-kv
Use when persisting tool data in Cloudflare KV - Describes bindings, key naming, and function conventions.
llm-inference
Use when wanting to interact with any LLM - Explains available inference endpoints so the agent selects suitable models.
github-integration
Use when building GitHub-based features - Explains auth token usage, Gist reading/writing and rendering helpers.
cdn-usage
Use when adding external browser dependencies via CDN - Provides CDN selection guidance to ensure reliable script loading.
maps
Use when building interactive map tools - Explains MapLibre setup, tiles, and common UI patterns.
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
Didn't find tool you were looking for?