skill-creator

Create, validate, and package Gemini CLI skills with scripts and templates.

Updated May 23, 2026
One-click install
npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill skill-creator-kiranimmadi2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/kiranimmadi2/promptforge-ai/tree/main/gemini-cli/packages/core/src/skills/builtin/skill-creator
Command: npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill skill-creator-kiranimmadi2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Building a new Gemini CLI skill from scratch requires knowing the SKILL.md format, frontmatter rules, directory conventions, and packaging steps. This Skill guides the entire lifecycle so new skills are correctly structured, validated, and distributable. ## Core Features & Use Cases - Skill Scaffolding: Run init_skill.cjs to generate a complete skill directory with SKILL.md template and example scripts, references, and assets folders. - Validation and Packaging: Use package_skill.cjs to validate frontmatter, naming, and TODOs, then produce a distributable .skill file. - Design Guidance: Apply progressive disclosure principles, naming conventions, and degrees-of-freedom guidance when writing skill instructions. - Use Case: When asked to build a pdf-editor skill, follow the seven-step process to gather examples, plan resources, initialize the directory, write SKILL.md, package it, and install it with gemini skills install. ## Quick Start Create a new skill named pdf-editor that can rotate and merge PDF files, then package and install it for me.

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 Gemini CLI skill?

Run node init_skill.cjs with a hyphen-case skill name and output path to generate a template directory. Then edit SKILL.md with proper frontmatter and instructions, add any needed scripts or references, and package it with package_skill.cjs.

What is the required structure of a SKILL.md file?

SKILL.md must start with YAML frontmatter containing a hyphen-case name and a single-line description under 1024 characters. The Markdown body after the frontmatter holds the operational instructions loaded when the skill triggers.

How do I package a skill into a .skill file?

Run node package_skill.cjs with the skill folder path and an optional output directory. The script validates the skill first, then creates a zip-based .skill file named after the skill folder.

Why does skill packaging fail with validation errors?

Packaging fails when SKILL.md is missing, frontmatter lacks name or description, the name is not hyphen-case, the description exceeds 1024 characters, or unresolved TODO markers remain in any file. Fix the reported errors and rerun the packaging command.

When should I use scripts versus references in a skill?

Use scripts for deterministic, repeatedly rewritten code that can execute without loading into context. Use references for documentation like schemas or API specs that the agent reads only when needed, keeping SKILL.md lean.