create-skill

Scaffold magenta.nvim skills with skill.md and optional TypeScript scripts.

9|2|Updated Feb 1, 2015
One-click install
npx skills add https://github.com/dlants/dotfiles --skill create-skill-dlants
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/dlants/dotfiles/tree/main/magenta-skills/create-skill
Command: npx skills add https://github.com/dlants/dotfiles --skill create-skill-dlants

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive guide for developers to create and integrate custom AI skills into their magenta.nvim environment, extending Claude's capabilities to automate specific workflows and tasks. It demystifies the process of structuring, documenting, and scripting new skills.

Core Features & Use Cases

  • Structured Skill Development: Learn the required file structure, including the mandatory skill.md and optional scripts/ directories.
  • Frontmatter Definition: Understand how to properly define skill metadata (name, description) for discovery and context.
  • TypeScript Script Integration: Get step-by-step instructions on how to write and execute TypeScript scripts within your skills using tsx and zx for advanced automation.
  • Use Case: A software engineer wants to create a custom skill that automates code refactoring specific to their project's conventions. This guide walks them through setting up the skill, writing the TypeScript logic, and making it available to Claude in magenta.nvim.

Quick Start

I need to create a new skill for magenta.nvim. Guide me through the process, including how to set up the skill.md file and integrate TypeScript scripts.

Frequently Asked Questions about create-skill

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

FAQPage Schema
How do I create a new skill for magenta.nvim?

Creating a magenta.nvim skill involves scaffolding a skill directory with a required skill.md file containing YAML frontmatter (name and description) and an optional scripts/ folder. The Skill guides you through the complete setup for both global (~/.magenta/skills/) and project-specific (.magenta/skills/) repositories.

What file structure do I need for a magenta.nvim skill?

A magenta.nvim skill requires a per-skill directory with a skill.md file that includes YAML frontmatter defining name and description, plus an optional scripts/ directory for TypeScript logic. This structure ensures proper discovery and execution within your magenta.nvim environment.

Can I use TypeScript scripts in my magenta.nvim skills?

Yes, magenta.nvim skills support TypeScript scripts executed via tsx, with zx available for shell commands. This enables you to write advanced automation logic that extends Claude's capabilities for project-specific workflows and tasks.

Where should I place my custom magenta.nvim skills?

Custom magenta.nvim skills go in either ~/.magenta/skills/ for global availability or .magenta/skills/ for project-specific skills. The Skill scaffolding process ensures correct directory placement and structure for both repository types.

What metadata must I define in my skill's frontmatter?

Skill frontmatter requires name and description fields in YAML format. This metadata enables proper skill discovery and context within magenta.nvim, allowing Claude to identify and use your custom skill.

How do I automate code refactoring with a custom magenta.nvim skill?

Write TypeScript logic in your skill's scripts/ directory to implement project-specific refactoring rules, then execute via tsx. The Skill guides you through integrating this automation into magenta.nvim so Claude can apply your conventions consistently.