skill-authoring

Define reusable agent skills in SKILL.md with YAML frontmatter.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/soq123/SE3354-Calo-fit --skill skill-authoring-soq123
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/soq123/SE3354-Calo-fit/tree/main/.local/skills/skill-authoring
Command: npx skills add https://github.com/soq123/SE3354-Calo-fit --skill skill-authoring-soq123

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create reusable, discoverable skills that extend agent capabilities, so tasks can be automated and shared across sessions.

Core Features & Use Cases

  • YAML frontmatter-driven SKILL.md at the root defines the skill and triggers discovery.
  • Optional directories (scripts/, references/, assets/) support extended behavior and documentation.
  • Skills can be iterated and updated by editing the SKILL.md file in the skill's folder.

Quick Start

Create a new skill by adding a SKILL.md with the required frontmatter in a new folder under .agents/skills/

Frequently Asked Questions about skill-authoring

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

FAQPage Schema
How do I create reusable agent skills for automated workflows?

To create reusable agent skills, add a SKILL.md file with YAML frontmatter defining the name and description inside a new folder under .agents/skills/. This enables agents to discover and apply the documented workflow across sessions.

What is a SKILL.md file and how does it work for agent discovery?

A SKILL.md file is a markdown document with required YAML frontmatter that triggers agent discovery for custom workflows. By defining a name and description at the root, it allows agents to automatically find and reuse the skill for recurring tasks.

How do I structure directories to support extended content when authoring skills?

When authoring skills, you can include optional scripts/, references/, and assets/ directories alongside the root SKILL.md file. These directories support extended behavior and documentation to enhance the skill's capabilities.

Can I update an existing agent workflow without rewriting the entire skill?

Yes, you can iterate and update existing agent workflows by editing the SKILL.md file directly in the skill's folder. This modifies the frontmatter and documentation to reflect the new workflow behavior across sessions.

Do I need any external dependencies to automate recurring tasks with agent skills?

No external dependencies are required to automate recurring tasks with agent skills. The system operates independently using the SKILL.md frontmatter and optional local directories to define and execute the documented workflows.