Claude MarketplacesSubmit
agentworkforce avatar

Creating Agent Skills Skill

agentworkforce/relay

If you're building Agent Skills packages for Codex CLI, GitHub Copilot, or Amp, this gives you the complete agentskills.io specification in one reference. It covers the frontmatter schema (name validation rules, required vs optional fields), directory structure conventions, and the progressive disclosure model that keeps skills under 500 lines for efficient context loading. The cross-tool compatibility section is handy since the same SKILL.md works everywhere, you just move it between .agents/skills and .github/skills. Honestly feels like documentation that should live in your editor when you're authoring skills instead of hunting through the spec site.

GitHub stars
719
last updated
Jun 11, 2026
View on GitHub

Install

$ npx -y skills add agentworkforce/relay --skill creating-agent-skills-skill --agent claude-code

Installs into .claude/skills of the current project.

Files

Overview

Agent Skills is an open standard for portable AI agent capabilities. One SKILL.md file works across Codex CLI, GitHub Copilot, and Amp.

Official Spec: https://agentskills.io/specification

Installation Directories

ToolLocation
Codex CLI.agents/skills/{skill-name}/SKILL.md
GitHub Copilot.github/skills/{skill-name}/SKILL.md
Amp.agents/skills/{skill-name}/SKILL.md

Directory Structure

```
my-skill/                 # Must match frontmatter `name`
├── SKILL.md              # Required - main definition
├── scripts/              # Optional - executable code
├── references/           # Optional - additional docs
└── assets/               # Optional - static resources

Frontmatter Specification

Required Fields
---
name: skill-name
description: What it does and when to use it
---
Optional Fields
SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/agentworkforce/relay
Categories
Git & Pull Requests, AI & Agent Building, CLI & Terminal
License
Apache-2.0
First seen
Jun 11, 2026

More from agentworkforce/relay

All 18

Recommended

More Git & Pull Requests
1agentworkforce avatarsetting-up-relayfileagentworkforce/relayWalks you through mounting cloud providers like Notion, Linear, and GitHub as local files so agents can read and write through normal...0skills.sh installs
2agnosticui avatarcheck-accessibilityagnosticui/agnosticuiReview component for accessibility issues0skills.sh installs
3anbeime avataricon-generatoranbeime/skill收录最全、更新最快的技能Skills 商店，涵盖文档处理、内容创作、编程开发、机器学习、自动化工作流等多个领域的 72 个精选技能包。所有技能已打包完成，可直接安装使用！ 该商店中自动抓取了 Github 上的所有的 Skills 项目，并按照分类、更新时间、Star 数量等标签进行整理。0skills.sh installs
4anbeime avatarobsidian-skills-integratedanbeime/skill收录最全、更新最快的技能Skills 商店，涵盖文档处理、内容创作、编程开发、机器学习、自动化工作流等多个领域的 72 个精选技能包。所有技能已打包完成，可直接安装使用！ 该商店中自动抓取了 Github 上的所有的 Skills 项目，并按照分类、更新时间、Star 数量等标签进行整理。0skills.sh installs
5anthropics avatarcookbook-auditanthropics/claude-cookbooksAudit an Anthropic Cookbook notebook based on a rubric. Use whenever a notebook review or audit is requested.0skills.sh installs
6ar9av avatarcontent-refinement-agentar9av/paperorchestraStep 5 of the PaperOrchestra pipeline (arXiv:2604.05018). Iteratively refine drafts/paper.tex by simulating peer review and applying targeted revisions, with st0skills.sh installs