skills.rest
nthpaul
nthpaulCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

skill-creator

Guide creation of modular Codex Skills with SKILL.md frontmatter and structured instructions.

Updated May 18, 2025
Search Tags:#workflow design#codex#skill authoring#context optimization#YAML frontmatter#resource planning
One-click install
npx skills add https://github.com/nthpaul/dotfiles --skill skill-creator-nthpaul
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/nthpaul/dotfiles/tree/main/codex/.codex/skills/.system/skill-creator
Command: npx skills add https://github.com/nthpaul/dotfiles --skill skill-creator-nthpaul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codex users need a reliable way to create effective Skills that are discoverable, correctly structured, and easy to maintain over time.

Core Features & Use Cases

  • Skill design guidance: Explains how Skills should be structured with mandatory SKILL.md frontmatter and operational body content.
  • Context-efficient writing rules: Provides principles for concise instructions and progressive disclosure to avoid context bloat.
  • Resource planning: Advises when to add scripts, references, and assets, and how to organize larger reference material.
  • Creation workflow: Lays out a step-by-step process for understanding, implementing, validating, and iterating on a Skill.

Quick Start

Use the skill-creator guidance to design a new skill folder by writing SKILL.md frontmatter (name and description) and then implementing the operational instructions in the Markdown body.

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 Codex skill with the correct SKILL.md structure?▼

To create a Codex skill, define the required YAML frontmatter fields in SKILL.md, then write concise operational instructions in the Markdown body following progressive disclosure rules to ensure proper skill discovery and loading.

What is progressive disclosure in skill authoring and why is it needed?▼

Progressive disclosure in skill authoring is a context optimization principle that structures instructions concisely, preventing context bloat by only revealing necessary operational details when required during skill execution.

How should I organize scripts, references, and assets when designing a workflow skill?▼

Organize bundled resources like scripts, references, and assets by following resource planning rules, separating larger reference material into dedicated files to maintain an efficient and modular skill folder structure.

What is the step-by-step process for implementing and validating a new skill?▼

The skill creation workflow involves a step-by-step process: understand the specialized workflow requirements, implement the modular instructions, validate the structure against the loading model, and iterate on the design.

Does my skill's YAML frontmatter need specific fields to be discovered by the loading model?▼

Yes, your skill requires mandatory YAML frontmatter fields, specifically name and description, to ensure compatibility with the Codex skill discovery and loading model for correct indexing and execution.

Related Skills

Explore More Software Engineering Skills→
rodrigo-altissimorodrigo-altissimo

skill-creator

Create valid Skill Unit directories with SKILL.md YAML frontmatter and packaging.

Community
Basic
FrekiManagarmFrekiManagarm

Skill Builder

Generate spec-compliant SKILL.md files with YAML frontmatter for Claude Code skills.

Community
Intermediate
vinnie357vinnie357
24

claude-skills

Creates modular Agent Skills with YAML frontmatter and progressive disclosure.

Community
Intermediate
IAmKongHaiIAmKongHai

ce-agent-native-architecture

Design intelligent agent-native applications with tools and primitives.

Community
Advanced