skill-creator

Create, validate, and package Claude skill directories with SKILL.md frontmatter.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill skill-creator-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/surfingalien/FinSurfing/tree/main/Downloads/FinSurfing/.agents/skills/skill-creator
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill skill-creator-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Building a well-structured skill from scratch requires knowing the SKILL.md frontmatter format, directory conventions, and packaging rules, which is error-prone when done manually. ## Core Features & Use Cases - Skill Scaffolding: Run scripts/init_skill.py to generate a new skill directory with a templated SKILL.md and example scripts/, references/, and assets/ folders. - Validation and Packaging: Use scripts/package_skill.py to validate frontmatter, naming conventions, and description quality, then produce a distributable zip file. - Authoring Guidance: Follow the six-step creation process covering concrete examples, resource planning, editing style, and iteration. - Use Case: When asked to build a new skill such as a pdf-editor, use this skill to initialize the directory, write the SKILL.md instructions, and package the result into a zip for distribution. ## Quick Start Create a new skill named pdf-editor using the skill-creator process and package it into a zip file.

Frequently Asked Questions about skill-creator

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

FAQPage Schema
How do I create a new Claude skill from scratch?

Run scripts/init_skill.py with a hyphen-case skill name and an output path. It generates a skill directory containing a SKILL.md template with TODO placeholders plus example scripts, references, and assets folders to customize.

What is required in a SKILL.md file?

SKILL.md must contain YAML frontmatter with a name and description field, followed by Markdown instructions. The name must be hyphen-case lowercase, and the description should explain what the skill does and when to use it.

How do I package a skill into a zip file?

Run scripts/package_skill.py with the path to the skill folder and an optional output directory. It validates the skill first and only creates the zip if validation passes.

Why does skill validation fail during packaging?

Validation fails when SKILL.md is missing, frontmatter lacks name or description, the name is not hyphen-case, or the description contains angle brackets. Fix the reported errors and rerun package_skill.py.

When should a skill include scripts, references, or assets?

Include scripts for deterministic repeated tasks, references for documentation loaded into context as needed, and assets for files used in outputs like templates or fonts. Delete any directories the skill does not need.