Contributing
A curated collection of reusable AI Agent Skills for standardized workflows, best practices, and domain expertise.
npx -y skills add Dqz00116/skill-lib --skill contributingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 22 stars22 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when contributing new skills to the skill-lib repository, installing skills locally, or verifying skill compliance with repository standards
SKILL.md
3.1 KB, as published. Nobody here has run it
Contributing to Skill-Lib
Guidelines for installing skills and contributing new ones to this repository.
Overview
Skill-Lib is a curated collection of reusable AI Agent Skills. Each skill follows the writing-skills standard with standardized frontmatter, structure, and content guidelines.
When to Use
- Adding a new skill to this repository
- Installing skills to your local workspace
- Updating existing skills to meet repository standards
- Understanding naming conventions and file structure requirements
Quick Reference
| Action | Command / Step |
|---|---|
| Install all skills | git clone https://github.com/Dqz00116/skill-lib.git then copy directories |
| Install single skill | Download skill-name/SKILL.md to ~/workspace/skills/skill-name/ |
| Add new skill | Create skill-name/SKILL.md following standards below |
| Update index | python scripts/generate-summary.py --write |
Installation
Install All Skills
git clone https://github.com/Dqz00116/skill-lib.git /tmp/skill-lib
mkdir -p ~/workspace/skills
cp -r /tmp/skill-lib/*/ ~/workspace/skills/
rm -rf /tmp/skill-lib
Install Single Skill
mkdir -p ~/workspace/skills/code-analysis
curl -o ~/workspace/skills/code-analysis/SKILL.md \
https://raw.githubusercontent.com/Dqz00116/skill-lib/main/code-analysis/SKILL.md
Verify Installation
Each skill must contain:
skill-name/
└── SKILL.md # Required
Optional: README.md, templates/, examples/, scripts/.
Contributing
Naming Conventions
| Item | Format | Example |
|---|---|---|
| Directory name | lowercase + hyphens | code-analysis |
SKILL.md filename | uppercase | SKILL.md |
name field | matches directory | code-analysis |
description | starts with Use when... | Use when analyzing unfamiliar code |
SKILL.md Standards
Required frontmatter:
---
name: skill-name
description: Use when [triggering conditions]
---
Required sections:
## Overview— 1-2 sentence summary## When to Use— triggering conditions and anti-cases
Recommended sections:
## Quick Reference— tables for scanning## Common Mistakes— what goes wrong and fixes
Content Guidelines
Must sanitize:
- Remove specific project paths
- Remove personal information
- Remove company-specific code
- Use generic examples
Submission Process
- Check for duplicate skills
- Create
skill-name/SKILL.mdfollowing standards - Sanitize all content
- Run
python scripts/generate-summary.py --writeto update index - Submit via Pull Request
Common Mistakes
| Mistake | Fix |
|---|---|
Missing ## Overview | Add 1-2 sentence summary after title |
description describes workflow | Rewrite to start with Use when... |
| Directory name uses camelCase | Use lowercase + hyphens |
| Specific paths in examples | Replace with generic placeholders |
| Forgetting to update index | Run generate-summary.py --write |