agents-md-to-skills

Convert AGENTS.md guidance into reusable Codex skill folders with SKILL.md frontmatter.

Updated Jan 3, 2026
One-click install
npx skills add https://github.com/barelyknown/agents-md-to-skills --skill agents-md-to-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-md-to-skills
Source: https://github.com/barelyknown/agents-md-to-skills/tree/main/agents-md-to-skills
Command: npx skills add https://github.com/barelyknown/agents-md-to-skills --skill agents-md-to-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts long or mixed-purpose AGENTS.md instructions into focused, reusable Codex skills, turning guidance into triggerable automation.

Core Features & Use Cases

  • Identify repeatable workflows, tool usage patterns, and domain knowledge from AGENTS.md.
  • Create skill folders with valid SKILL.md frontmatter and lean, actionable instructions.
  • Update AGENTS.md to reference the newly created skills and maintain repository-wide rules.

Quick Start

Invoke this skill to refactor an AGENTS.md into focused, reusable Codex skills.

Frequently Asked Questions about agents-md-to-skills

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

FAQPage Schema
How do I convert AGENTS.md instructions into reusable Codex skills?

To convert AGENTS.md instructions into reusable Codex skills, this tool extracts repeatable workflows and domain knowledge, packaging them into skill folders with valid SKILL.md frontmatter and actionable instructions.

What is the best way to refactor a mixed-purpose AGENTS.md file into focused automation?

Refactoring an AGENTS.md file involves grouping multi-step processes and tool workflows into separate, triggerable skill folders, then updating the original file to reference the newly created skills.

How does AGENTS.md skill packaging handle large reference materials?

During skill packaging, large reference materials extracted from AGENTS.md are placed into a dedicated references/ directory, while optional assets and scripts are created as needed to support the workflow.

When should I extract domain knowledge from AGENTS.md into separate skill folders?

You should extract domain knowledge into separate skill folders when your AGENTS.md contains multi-step processes or tool workflows that need to be triggered as focused, reusable automation instead of static instructions.

Does this skill packaging process update the original AGENTS.md file?

Yes, the skill packaging process updates the original AGENTS.md file to reference the newly created skills, ensuring that repository-wide rules are maintained while specific workflows are externalized.