skill-creator

Guide creation of SKILL.md metadata and structured guidance for Claude skills.

406|31|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/gotalab/skillport --skill skill-creator-gotalab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/gotalab/skillport/tree/main/.agent/skills/skill-creator
Command: npx skills add https://github.com/gotalab/skillport --skill skill-creator-gotalab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill guides users through the process of designing and building effective Claude Skills, ensuring they are concise, well-structured, and leverage bundled resources efficiently. This streamlines skill development and maximizes AI performance.

Core Features & Use Cases

  • Core Principles: Teaches conciseness, appropriate degrees of freedom, and the anatomy of a skill (SKILL.md, scripts, references, assets).
  • Progressive Disclosure: Explains how to manage context efficiently using a three-level loading system to minimize context bloat.
  • Structured Workflow: Provides a step-by-step process from understanding skill needs to planning, initializing, editing, and packaging skills.
  • Use Case: A developer wants to create a new Claude Skill to automate a specific business process. This skill will provide comprehensive guidance and best practices to ensure the new skill is robust and effective.

Quick Start

I want to create a new skill called 'data-analyzer' to process CSV files. Guide me through the initial steps of skill creation.

Frequently Asked Questions about skill-creator

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

FAQPage Schema
How do I structure a Claude Skill with SKILL.md metadata?

A Claude Skill requires strict YAML frontmatter in SKILL.md with required fields like name and description, followed by markdown body sections. The name must use hyphen-case, descriptions must avoid angle brackets, and you organize supporting scripts, references, and assets in bundled directories to keep context efficient and the skill maintainable.

What's the best way to manage context in Claude Skills?

Claude Skills use three-level progressive disclosure to minimize context bloat: load essential metadata first, then scripts and references on demand, and assets only when needed. This structured approach ensures your skill performs efficiently without overwhelming Claude's context window with unnecessary information upfront.

Can I build a Claude Skill to automate a business workflow?

Yes. Claude Skills support domain knowledge, workflows, and tool integrations through a step-by-step process: define skill requirements, plan the structure, initialize SKILL.md with proper frontmatter, edit sections for your workflow logic, and package bundled resources. This design ensures your automation is robust and AI-ready.

What naming conventions and length limits apply to Claude Skills?

Skill names must use hyphen-case (e.g., data-analyzer, report-generator) and descriptions have enforced length limits to maintain conciseness. These constraints ensure metadata remains scannable and skills integrate cleanly into larger AI systems without naming conflicts or context bloat.

How do I organize scripts and references in a skill package?

Bundle scripts and references as separate components within your skill directory structure. Scripts handle execution logic while references provide supporting data or documentation. This separation keeps your SKILL.md lean and allows Claude to load only the components needed for each task, improving performance.