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.