agent-skills-authoring
Ensures consistency in AI agent skill development by enforcing standard naming, file structure, and documentation requirements.
Install
mkdir -p .claude/skills/agent-skills-authoring && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/17963" && unzip -o skill.zip -d .claude/skills/agent-skills-authoring && rm skill.zipInstalls to .claude/skills/agent-skills-authoring
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Use this skill when you are creating or updating Agent Skills in `.github/skills/` (structure, YAML frontmatter, naming, and progressive disclosure).Key capabilities
- →Define skill directory structure within `.github/skills/`.
- →Specify YAML frontmatter requirements for `SKILL.md`.
- →Guide progressive disclosure of skill metadata and resources.
- →Recommend sections for skill documentation.
- →Provide guidance on cost and performance notes.
How it works
The skill outlines the required directory structure, YAML frontmatter fields, and documentation sections for agent skills, emphasizing progressive disclosure and centralized performance guidance.
Inputs & outputs
When to use agent-skills-authoring
- →Create a new agent skill directory
- →Add YAML frontmatter to a skill
- →Update existing skill documentation
- →Ensure skill complies with repo standards
About this skill
Agent Skills Authoring for Freelancerino
Use this skill when creating or updating skills in .github/skills/.
Spec essentials
- Directory per skill:
.github/skills/<skill-name>/ SKILL.mdrequired with YAML frontmatter:name: lowercase, a-z0-9-hyphen, 1-64 chars, no leading/trailing/consecutive hyphens; must match directory namedescription: 1-1024 chars; describe what + when to use- Optional:
license,compatibility,metadata(map),allowed-tools(space-delimited)
- Body: instructions, steps, examples. Keep under ~500 lines; move deep refs to
references/.
Progressive disclosure
- Metadata (name/description) always loaded.
- Body loads when skill matches.
- Resources load on demand (scripts, references, assets). Keep references one level deep.
Recommended sections
- Purpose and when to use
- Required steps/checklist
- Patterns/examples
- Edge cases
- Testing/validation
- References to repo files
Cost & performance guidance for skills
When authoring or updating a skill, keep cost/perf advice centralized and non-duplicative:
- If the skill is about Next.js behavior (routing, Server Actions, caching, streaming), prefer linking to:
.github/skills/nextjs-cost-performance/SKILL.md
- If the skill is about DB access patterns, link to:
.github/skills/drizzle-tenant-queries/SKILL.md
- If the skill is about security/caching risks, link to:
.github/skills/security-strict/SKILL.md
Avoid copying large performance checklists into every skill. Instead:
- Add a short “Cost & performance notes” section with 3–6 bullets.
- Keep it tenant-safe (workspace-scoped keys/tags).
- Prefer “how to verify” steps (lint/typecheck/test/build) over speculative advice.
Validation
- Use
skills-ref validate .github/skills/<skill>if available.
Security
- If adding scripts, note dependencies and risks. Consider allowlists/sandboxing.
References
- Agent Skills spec: https://agentskills.io/specification
- Integration guide: https://agentskills.io/integrate-skills
- VS Code skills doc: https://code.visualstudio.com/docs/copilot/customization/agent-skills
When not to use it
- →When authoring documentation outside of agent skills.
- →When the task is not related to creating or updating skills.
- →When the user wants to copy large performance checklists into every skill.
Limitations
- →The skill applies to agent skills within `.github/skills/`.
- →The skill requires `SKILL.md` with YAML frontmatter.
- →The skill recommends keeping skill bodies under ~500 lines.
How it compares
This skill provides a structured framework for authoring agent skills, ensuring consistency and adherence to specific repository standards, unlike general documentation practices.
Compared to similar skills
agent-skills-authoring side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| agent-skills-authoring (this skill) | 0 | 7mo | No flags | Beginner |
| skill-creator | 128 | 3mo | Review | Advanced |
| skill-development | 17 | 8mo | Review | Intermediate |
| agent-identifier | 15 | 8mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
skill-creator
anthropics
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
skill-development
anthropics
This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.
agent-identifier
anthropics
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
llama-factory
zechenzhangAGI
Expert guidance for fine-tuning LLMs with LLaMA-Factory - WebUI no-code, 100+ models, 2/3/4/5/6/8-bit QLoRA, multimodal support
dify-dsl-generator
wwwzhouhui
专业的 Dify 工作流 DSL/YML 文件生成器，根据用户业务需求自动生成完整的 Dify 工作流配置文件，支持各种节点类型和复杂工作流逻辑
character-generator
Dexploarer
Generate complete elizaOS character configurations with personality, knowledge, and plugin setup. Triggers when user asks to "create character", "generate agent config", or "build elizaOS character"