Agent Skills

A collection of reusable skills for AI coding agents, following the Agent Skills specification.

What are Agent Skills?

Agent Skills are self-contained, portable instruction sets that extend an AI agent's capabilities. Each skill provides step-by-step workflows, helper scripts, and reference documentation for a specific domain or tool.

Available Skills

Skill	Description
aws-architect	AWS Certified Solutions Architect Expert persona for architecture design, troubleshooting, security, and cost optimization
context7	Retrieve up-to-date documentation for software libraries via the Context7 API

Installation

Clone this repository into your project or add it as a submodule:

git clone https://github.com/your-org/agent-skills.git .agent/skills

Or add individual skills:

mkdir -p .agent/skills
cp -r path/to/agent-skills/skills/context7 .agent/skills/

You can also install directly via the skills CLI:

npx skills add https://github.com/jnd0/agent-skills --skill context7

Usage

Skills are designed to be discovered and activated by AI agents. The agent reads the skill's SKILL.md file and follows the instructions to complete tasks.

Manual Testing

You can test skill scripts directly:

# Context7 - Search for library documentation
./skills/context7/scripts/context7.py search react hooks
./skills/context7/scripts/context7.sh search nextjs "app router"

# Context7 - Fetch documentation snippets
./skills/context7/scripts/context7.py fetch /websites/react_dev_reference useState
CONTEXT7_TYPE=txt ./skills/context7/scripts/context7.sh fetch /vercel/next.js "app router"

Note: Scripts may need to be made executable first:

chmod +x skills/*/scripts/*

Skill Structure

Each skill follows the Agent Skills specification:

skill-name/
├── SKILL.md              # Required - Main instructions with YAML frontmatter
├── scripts/              # Optional - Helper scripts
├── references/           # Optional - Detailed documentation
└── assets/               # Optional - Templates, images, data files

SKILL.md Format

---
name: skill-name
description: What the skill does and when to use it
license: MIT
compatibility: Required tools or environment
metadata:
  author: your-org
  version: "1.0"
allowed-tools: Bash(tool:*) Read
---

# Skill Title

Step-by-step instructions, examples, and edge cases.

Contributing

1. Create a new directory under skills/ matching your skill name
2. Add a SKILL.md following the specification
3. Include helper scripts and references as needed
4. Test your skill with the validation tool:

   npx skills-ref validate ./skills/your-skill

License

MIT License - See individual skills for their specific licenses.

Resources

• Agent Skills Specification
• What are Skills?
• Integrate Skills