skill-authoring

Create reusable agent skills with SKILL.md and YAML frontmatter.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/offers-png/one-time-checkout --skill skill-authoring-offers-png
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/offers-png/one-time-checkout/tree/main/.local/skills/skill-authoring
Command: npx skills add https://github.com/offers-png/one-time-checkout --skill skill-authoring-offers-png

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating and maintaining reusable skills to extend agent capabilities, enabling consistent task handling across sessions and reducing repeated setup.

Core Features & Use Cases

  • Save reusable knowledge, procedures, and workflows that persist across sessions.
  • Define new skills and document them for future use and handoffs.
  • Organize skills under .agents/skills/ for discovery and iterative improvement.

Quick Start

Create a new skill named your-skill-name and save it to .agents/skills/your-skill-name/SKILL.md.

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 that persist across sessions?

To create reusable agent skills, define new workflows and document them in a SKILL.md file. This preserves knowledge across sessions, ensuring consistent task handling and reducing repeated setup.

What is YAML frontmatter and why is it needed for skill documentation?

YAML frontmatter provides structured metadata for skill discovery. Enforcing frontmatter with name and description fields ensures your documented workflows are identifiable and reusable by agents across different sessions.

How do I organize agent skills for discovery and iterative improvement?

Organize agent skills by saving them under the .agents/skills/ directory structure. Place each skill in its own folder, such as .agents/skills/your-skill-name/SKILL.md, to enable proper discovery.

Can I include optional resources directories when authoring agent workflows?

Yes, skill authoring recognizes optional resources directories within the skill folder. These directories store supplementary files alongside your SKILL.md to support complex workflows and provide additional context for agents.

What's the best way to document workflows for future use and handoffs?

Document workflows for handoffs by creating a SKILL.md file with required YAML frontmatter. This structured approach captures procedures and knowledge, making them discoverable and reusable for future agent sessions.