skill-development

Creates and repairs Claude skills with lean SKILL.md files and verified local references.

Updated Oct 7, 2022
One-click install
npx skills add https://github.com/tamagusko/linux-cfg --skill skill-development-tamagusko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/tamagusko/linux-cfg/tree/main/dotfiles/claude/skills/skill-development
Command: npx skills add https://github.com/tamagusko/linux-cfg --skill skill-development-tamagusko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Claude skills often suffer from bloated SKILL.md files, broken references to nonexistent files, stale agent names, and weak trigger descriptions that prevent reliable activation. This Skill provides a structured workflow to create new skills or repair existing ones so they stay lean, consistent, and grounded in the actual local environment. ## Core Features & Use Cases - Skill creation and repair workflow: A six-step default process covering environment inspection, contract definition, frontmatter writing, main file slimming, resource validation, and integrity checks. - Trigger description guidance: Rules for writing third-person frontmatter descriptions with concrete user phrases that improve skill discovery. - Integrity verification: Bundled references provide checklists and concrete shell commands (rg, find) to detect dead references, drift between frontmatter names and directory slugs, and leftover artifacts. - Use Case: A user asks to fix an existing skill whose SKILL.md references files that were deleted. The Skill inspects the directory, removes dead references, rebalances content into references/, and runs integrity checks before closing. ## Quick Start Use the skill-development skill to review my existing skill in this directory, fix any broken references, and tighten its trigger description.

Frequently Asked Questions about skill-development

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

FAQPage Schema
How do I create a new Claude skill?

Define the skill's contract first: what it does, what triggers it, what it excludes, and which bundled resources it needs. Then write a SKILL.md with third-person frontmatter description, keep the body lean, and add references or scripts only when they are actually used.

How do I write a good skill trigger description?

Use third-person phrasing like "This skill should be used when the user asks to..." and include concrete phrases a user would naturally say. Keep it short enough to scan quickly and make sure it reflects the skill's real scope.

How do I fix a skill with broken file references?

Run rg over SKILL.md to list every mention of references/, examples/, or scripts/, then verify each path exists on disk. Remove dead paths immediately and replace historical agent or plugin names with current local names.

When should content move from SKILL.md into references?

Move templates, exhaustive checklists, edge-case catalogs, sample outputs, and long examples into references/ when they make the main file hard to scan. Keep only the goal, boundaries, default workflow, and a short resource list in SKILL.md.

What integrity checks should run before finishing a skill edit?

Verify the frontmatter parses, all referenced local files exist, sibling skill and agent references are real, and no caches or editor artifacts remain. The bundled integrity-checks reference provides concrete rg and find commands for this.