0

Adding or changing a skill

agent-skillsrules

Anti-duplication guardrail for adding or changing skills

Sign in to save downloads to your library and vote.

Preview

Metadata (frontmatter)
description: Anti-duplication guardrail for adding or changing skills
paths:
  - "skills/**"

Adding or changing a skill

This repo already covers most of the development lifecycle, so most new-skill ideas overlap an existing skill or an open PR. Before creating a new skills/<name>/ directory or significantly reworking an existing one:

  • Run the pre-flight checks in CONTRIBUTING.md: search the catalog, check open PRs (gh pr list --state open), and justify the gap.
  • Prefer extending an existing skill over adding a near-duplicate. If the idea overlaps an existing skill, edit that skill instead of adding a new directory.
  • Keep the SKILL.md within docs/skill-anatomy.md, and never duplicate content between skills, reference the other skill instead.

CONTRIBUTING.md is the single source of truth for the full workflow; this rule points to it rather than restating its checklist.

Ingestion metadata

Source catalog
agent-skills
Repository
addyosmani/agent-skills · main
File path
.claude/rules/skills-contributing.md
Last refreshed
10/24/2026, 3:00:12 AM (5h ago)
Refresh schedule
Daily · 03:00 UTC
Dedupe status
Unique · deduped by (source, url)