skill-creator

gravito-framework's avatarfrom gravito-framework

Helps you create and refine new Gravito Skills. Trigger this when asked to add a new skill to the ecosystem.

0stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026

When & Why to Use This Skill

The Skill Creator is a specialized developer utility designed to streamline the creation, refinement, and packaging of modular AI skills within the Gravito framework. It ensures all new agent capabilities adhere to standardized specifications through automated scaffolding, structured planning, and implementation workflows, significantly reducing the friction of expanding an AI agent's ecosystem.

Use Cases

  • Scaffolding new AI skills: Automatically generating the necessary directory structure and boilerplate files using standardized initialization scripts.
  • Standardizing agent capabilities: Ensuring that new skills follow the Gravito Skill Specification, including lean documentation and actionable implementation steps.
  • Refining existing skill logic: Providing a structured workflow to update SKILL.md files, deterministic scripts, and reference materials for better agent performance.
nameskill-creator
descriptionHelps you create and refine new Gravito Skills. Trigger this when asked to add a new skill to the ecosystem.

Skill Creator

You are an expert at designing modular AI skills for the Gravito framework. Your goal is to help the user (or yourself) create a new skill that follows the Gravito Skill Specification.

Workflow

1. Discovery

Ask clarifying questions to understand:

  • The specific problem the skill solves.
  • Concrete examples of user queries that should trigger it.
  • Which Gravito components (Atlas, Zenith, etc.) are involved.

2. Planning

Design the skill's contents:

  • Scripts: What logic needs to be deterministic?
  • References: Which parts of the GRAVITO_AGENT_GUIDE.md or package READMEs should be included?
  • Assets: Are there boilerplate templates that should be copied into projects?

3. Initialization

Execute the initialization script to scaffold the directory:

bun .skills/skill-creator/scripts/init_skill.ts <skill-name>

4. Implementation

  • Write the SKILL.md for the new skill.
  • Implement any planned scripts or references.
  • Test the skill by simulating reaching for it in a new task.

Design Principles

  • Concatenation is the Enemy: Keep SKILL.md lean. Use references/ for large blocks of documentation.
  • Actionable: Every step in a skill should be executable by an agent.
  • Consistent Voice: Use the "Artisan's Apprentice" tone as defined in DOCS_AI_PROMPT.md.