Skip to content
Skills Library
AI & agents · Building & coding

contributing

/contributing

Use when contributing new skills to the skill-lib repository, installing skills locally, or verifying skill compliance with repository standards

Repository
skill-lib ↗
Licence
MIT
Last repository change
29.05.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 29.05.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when contributing new skills to the skill-lib repository, installing skills locally, or verifying skill compliance with repository standards

Original author description

Use when contributing new skills to the skill-lib repository, installing skills locally, or verifying skill compliance with repository standards

How it works

  1. Overview
  2. When to Use
  3. Quick Reference
  4. Installation
  5. Contributing
  6. Common Mistakes
Original SKILL.md headings · 109 lines, 408 words
SKILL.md preview
---
name: contributing
description: Use when contributing new skills to the skill-lib repository, installing skills locally, or verifying skill compliance with repository standards
---

# 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

```bash
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

```bash
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:
```yaml
---
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

1. Check for duplicate skills
2. Create `skill-name/SKILL.md` following standards
3. Sanitize all content
4. Run `python scripts/generate-summary.py --write` to update index
5. 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` |

Versions

RepositoryScoreLicence
This page · Dqz00116/skill-lib100MIT
butterbase-ai/butterbase-skills100MIT
cloudflare/cloudflare-docs100CC-BY-4.0
blaizzy/mlx-vlm100MIT
emmgeede/gridselect100MIT
Jeff-Kazzee/github-skills100MIT
googlecloudplatform/race-condition100Apache-2.0
iowarp/clio-core84BSD-3-Clause

Database snapshot: 13.11.2026 · package version 980c34b1995e (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100writing-skills
    Use when creating new skills, editing existing skills, or verifying skills work before deployment
  • 100skill-development
    Create and contribute skills to the communal knowledge base. Use when creating new skills, updating existing skills, or contributing learnings back to the repository.
  • 95writing-skills
    Use when creating new skills, editing existing skills, or verifying skills work before deployment
  • 95writing-skills
    Use when creating new skills, editing existing skills, or verifying skills work before deployment
  • 100writing-skills
    Use when creating new skills, editing existing skills, or verifying skills work before deployment
  • 100writing-skills
    Use when creating new skills, editing existing skills, or verifying skills work before deployment

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.