skills.rest
dbosk
dboskCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

skill-management

Guide safe creation, updating, and maintenance of Claude Code skills.

1|1|Updated Nov 4, 2025
Search Tags:#skill development#quality assurance#best practices#AI workflow#AI agent#claude skills#git management
One-click install
npx skills add https://github.com/dbosk/claude-skills --skill skill-management
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-management
Source: https://github.com/dbosk/claude-skills/tree/main/skill-management
Command: npx skills add https://github.com/dbosk/claude-skills --skill skill-management

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users need to create and maintain high-quality Claude Skills but may struggle with best practices, optimal structure, and consistent version control. This skill ensures all modifications adhere to official guidelines and are properly committed, saving you rework and ensuring skill effectiveness.

Core Features & Use Cases

  • Best Practice Enforcement: Guides you through official Claude Code skill requirements for conciseness, progressive disclosure, and effective descriptions.
  • Quality Checklist: Provides a comprehensive checklist for core requirements, content quality, architecture, and testing before skill completion.
  • Git Integration: Ensures all skill modifications are properly committed to the skills repository, maintaining version control and trackability.
  • Use Case: When you're asked to create a new skill for handling API documentation, activate this skill first to ensure you follow all design principles, structure requirements, and commit procedures from the start.

Quick Start

I need to create a new Claude skill. Guide me through the best practices for skill creation and management.

Frequently Asked Questions about skill-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Claude skill following best practices?▼

Create a Claude skill by structuring it with YAML frontmatter, concise descriptions, and a three-level architecture: Metadata, Instructions, and Resources. Follow official guidelines for progressive disclosure and maintain Git commits throughout the process to ensure version control and trackability.

What's the best way to organize skill files and maintain version control?▼

Organize skills within ~/.claude/skills/ with proper SKILL.md templates and related scripts. Git commits are mandatory for all modifications, ensuring every change is tracked and the skill repository remains maintainable and auditable.

How do I ensure my skill meets quality and architectural requirements?▼

Use the quality checklist covering core requirements, content quality, architecture, and testing. Validate YAML frontmatter, confirm adherence to the three-level loading architecture, and verify activation order before completing your skill.

Can I update existing skills and maintain consistency across modifications?▼

Yes. Update existing SKILL.md and related files in ~/.claude/skills/ while enforcing the same best practices and YAML frontmatter validation. All edits must be committed to Git to maintain consistency and prevent workflow gaps.

What governance practices should I follow when editing skill-related scripts?▼

Apply proactive activation and mandatory Git commit discipline to all script modifications. Validate changes against official Claude Code skill requirements to avoid rework and ensure skills remain effective and compliant.

Related Skills

Explore More Software Engineering Skills→
Hoang130203Hoang130203

template-skill

Define new skills using YAML frontmatter and Markdown body structure.

Community
Basic
Starchild-ai-agentStarchild-ai-agent
1

@554/publish-test

Test the automated skill publishing pipeline with a Python verification script.

Official
Basic
bsamieebsamiee
1

agent-builder

Create Claude Code agent files with YAML frontmatter and tool permissions.

Community
Basic
cpfcoachingcpfcoaching

git-workflow-and-versioning

Teach structured git workflows including trunk-based development and atomic commits.

Community
Intermediate