Contributing to N-skills

Contributing to n-skills

This is a **curated marketplace**. All submissions are reviewed for quality and compliance with the [Agent Skills specification](https://agentskills.io/specification).

---

Official Specification Reference

n-skills follows the **agentskills.io** open standard, adopted by Claude Code, Codex, and other AI tools.

SKILL.md Requirements

Every skill MUST have a `SKILL.md` file with YAML frontmatter:

---
name: skill-name
description: A description of what this skill does and when to use it.
---

# Skill Name

[Instructions for the AI agent]

Required Frontmatter Fields

Field	Constraints
name	Max 64 characters. Lowercase letters, numbers, and hyphens only. Must not start or end with hyphen. No consecutive hyphens. Must match parent directory name.
description	Max 1024 characters. Should describe what the skill does AND when to use it. Include keywords for agent discovery.

Optional Frontmatter Fields

Field	Purpose
license	License name or path to LICENSE file
compatibility	Environment requirements (e.g., "Requires python>=3.8")
metadata	Key-value pairs for author, version, etc.
allowed-tools	Space-delimited list of pre-approved tools

Name Field Rules

# VALID
name: pdf-processing
name: data-analysis
name: code-review

# INVALID
name: PDF-Processing      # uppercase not allowed
name: -pdf               # cannot start with hyphen
name: pdf--processing    # consecutive hyphens not allowed
name: my_skill           # underscores not allowed

Description Best Practices

**Good:**

description: Extracts text and tables from PDF files, fills PDF forms, and merges multiple PDFs. Use when working with PDF documents or when the user mentions PDFs, forms, or document extraction.

**Poor:**

description: Helps with PDFs.

---

Skill Compliance Checklist

Use this checklist when adding any new skill:

SKILL.md File

undefined

Directory Structure

undefined

skill-name/
├── SKILL.md              # Required
├── references/           # Optional: supporting docs
├── scripts/              # Optional: executable code
└── assets/               # Optional: templates, configs