skill-builder

Create and improve AI skills with SKILL.md generation and checklist-driven review.

4|Updated Nov 22, 2025
One-click install
npx skills add https://github.com/r1cA18/dotfiles --skill skill-builder-r1ca18
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-builder
Source: https://github.com/r1cA18/dotfiles/tree/main/skills/skill-builder
Command: npx skills add https://github.com/r1cA18/dotfiles --skill skill-builder-r1ca18

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the creation and improvement of new AI skills, ensuring they are high-quality, well-documented, and integrated into the dotfiles ecosystem.

Core Features & Use Cases

  • Skill Creation: Guides users through defining use cases, selecting architectures, and generating SKILL.md files from scratch.
  • Skill Improvement: Analyzes existing skills against a quality checklist and suggests/implements improvements.
  • Use Case: A developer needs to create a new skill to manage cloud deployments. They use this skill to define the skill's purpose, triggers, and structure, generating a robust SKILL.md and necessary reference files.

Quick Start

Use the skill-builder to create a new skill for managing git repositories.

Frequently Asked Questions about skill-builder

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

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

To create an AI skill, you are guided through use-case discovery, architecture selection, and SKILL.md generation, ensuring the new skill adheres to progressive disclosure and Nix-aware path conventions.

How can I improve an existing AI skill's documentation?

To improve an existing AI skill, this tool analyzes it against a structured, checklist-driven review process to suggest or implement refinements that enhance quality and documentation within your dotfiles framework.

What is progressive disclosure in AI skill development?

Progressive disclosure in AI skill development is an architecture pattern that structures SKILL.md files to reveal information iteratively, ensuring the AI agent receives necessary context without overload.

Do I need Nix to generate SKILL.md files?

You do not strictly need Nix to generate SKILL.md files, but the tool uses Nix-aware path conventions to ensure the created or refined AI skills integrate seamlessly into the dotfiles ecosystem.

What is the best way to structure an AI agent workflow?

The best way to structure an AI agent workflow is by selecting an appropriate architecture during skill creation, defining clear triggers, and generating a robust SKILL.md to manage the workflow automation logic.