add-skill

Create and register new agent skills in the .agents/skills/ directory.

3|2|Updated May 20, 2026
One-click install
npx skills add https://github.com/openkaiden/openshell-image-builder --skill add-skill-openkaiden
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-skill
Source: https://github.com/openkaiden/openshell-image-builder/tree/main/.agents/skills/add-skill
Command: npx skills add https://github.com/openkaiden/openshell-image-builder --skill add-skill-openkaiden

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates inconsistency in project documentation by providing a standardized workflow for creating, formatting, and registering new agent skills.

Core Features & Use Cases

  • Standardized Structure: Ensures every new skill follows the required directory layout and YAML frontmatter format.
  • Registration Automation: Guides the user through updating the central skills index to maintain project discoverability.
  • Use Case: When adding a new capability to an OpenShell agent, use this Skill to generate the necessary directory structure and ensure the new skill is correctly indexed in the project README.

Quick Start

Use the add-skill skill to create a new skill named data-parser with the description Parse raw input into structured JSON.

Frequently Asked Questions about add-skill

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

FAQPage Schema
How do I standardize agent skill creation and registration in my project?

Standardizing agent skill creation involves applying a consistent directory layout and YAML frontmatter format within the .agents/skills/ structure. This ensures every new project skill follows the required schema and is correctly indexed in the project README.

What is the best way to add a new capability to an OpenShell agent?

The best way to add an OpenShell agent capability is to generate the necessary directory structure using a standardized scaffolding workflow. This guides you through updating the central skills index to maintain project discoverability.

How does manual registration in the project skills index work?

Manual registration in the project skills index requires you to update the central project README after creating a new skill. This maintains project discoverability by ensuring the newly added agent skill is correctly listed and documented.

Do I need a specific frontmatter schema to create new project skills?

Yes, creating new project skills requires adherence to a defined SKILL.md frontmatter schema. This standardized YAML format ensures your new agent skill is properly structured within the .agents/skills/ directory.

Can I use this scaffolding workflow for project maintenance and agent capability expansion?

Yes, this scaffolding workflow applies directly to project maintenance and agent capability expansion workflows. It eliminates inconsistency in project documentation by providing a standardized process for registering new agent skills.

Why does adding a new agent skill require updating the central skills index?

Updating the central skills index is required to maintain project discoverability when adding a new agent skill. It ensures the new capability is correctly indexed in the project README so the agent can locate and use it.