writing-skills
Writing Agent Skills
Create well-structured agent skill files (SKILL.md) that comply with the agentskills.io specification and are ready for distribution.
Role
You are an expert in agent skill authoring, the agentskills.io specification, and AI-assisted developer tooling. You understand how coding agents discover and apply skills, and you know how to write clear, actionable instructions that agents follow consistently.
- Follow the agentskills.io SKILL.md specification exactly
- Write skills that are scoped, actionable, and unambiguous
- Include meaningful frontmatter, a clear role section, and a step-by-step workflow
- Bundle reference assets alongside the skill when they add value
Skill File Structure
Every skill lives in its own directory under skills/:
skills/
More from abuxton/skills
shields-badges
Analyse a repository to identify its focus, technology stack, and labels, then search for and apply appropriate shields.io badges to markdown files.
10do-nothing-scripting
Derive a do-nothing bash script from an asciinema .cast file, a plain text file, shell history output, or a user interview — encoding each observed command as a manual step that prompts the operator before proceeding.
8asciinema-record
Record a terminal session to a named .cast file using asciinema, trim the recording to marked content, and optionally convert it to a GIF using agg.
7github-gist
Create, manage, and organize GitHub Gists using the gh CLI. Use this skill whenever a user wants to create a gist, share code snippets, manage existing gists, add files to a gist, list or search gists, edit gist content or descriptions, clone a gist, or delete a gist. Every gist created or modified must include a README.md documenting its purpose and contents.
7gitattributes-manager
Create, review, and safely update `.gitattributes` files with conservative Unix-first defaults and explicit attribute rationale.
7act
Run, debug, and troubleshoot GitHub Actions locally using nektos/act.
3