mcpField
S
skill-creator

skill-creator

github.com/gravito-frameworkAgent workflows248 installsUpdated 27w ago
Repository

About skill-creator

A workflow guide for designing AI skills for the Gravito framework, intended for developers or agents creating skills that follow the Gravito Skill Specification. It covers discovery, planning, scaffolding, implementation, and testing.

Key features

  1. 01Clarify goals and triggering queries
  2. 02Plan scripts, references, and assets
  3. 03Scaffold a skill directory
  4. 04Write and test SKILL.md
  5. 05Keep instructions concise and actionable

Use cases

  1. 01Gather requirements for a new skill
  2. 02Plan its files and deterministic logic
  3. 03Initialize and implement a skill

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gravito-framework/gravito --skill skill-creator

After installing, type/skill-creatorin Claude Code to confirm it loaded.

Bundled filesscripts/init_skill.ts

Details

From the project README

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.

Comments

Markdown supported