skill-aligner

Rewrites SKILL.md files to align terminology and metadata with repository conventions.

1|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/DaFum/neurotoxic-game --skill skill-aligner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-aligner
Source: https://github.com/DaFum/neurotoxic-game/tree/main/.agents/skills/skill-aligner
Command: npx skills add https://github.com/DaFum/neurotoxic-game --skill skill-aligner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Harmonizes and standardizes skill definitions to match the repository's current conventions and constraints.

Core Features & Use Cases

  • Rewrites SKILL.md frontmatter to ensure required fields (name, description) are present and correctly formatted.
  • Validates compatibility against AGENTS.md, domain-specific rules, and script references, updating terminology and trigger phrases as needed.
  • Produces aligned metadata and an alignment report to guide reviewers and maintainers.

Quick Start

Invoke the aligner to scan AGENTS.md and existing .agents/skills SKILL.md files, then rewrite each SKILL.md to conform to the repository's conventions.

Frequently Asked Questions about skill-aligner

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

FAQPage Schema
How do I align SKILL.md frontmatter and terminology with my repository conventions?

To align SKILL.md frontmatter and terminology, you can scan AGENTS.md guidance and existing skill definitions to rewrite metadata, ensuring required fields and trigger phrases match your repo constraints. This harmonizes multi-skill repositories by updating terminology and script references.

What is the best way to standardize skill definitions across a multi-skill repository?

Standardizing skill definitions involves validating compatibility against AGENTS.md, domain-specific rules, and script references. It rewrites SKILL.md files to conform to official terminology, ensuring Key Files, Related Skills, and trigger guidance remain consistent across the codebase.

How does an aligner handle mismatches between SKILL.md files and AGENTS.md guidance?

An aligner handles mismatches by scanning AGENTS.md and existing .agents/skills SKILL.md files, then rewriting each SKILL.md to conform to repository conventions. It updates terminology and trigger phrases, outputting aligned files and an alignment report for review.

Can I validate SKILL.md compatibility against domain-specific rules and script references?

Yes, you can validate SKILL.md compatibility against domain-specific rules and script references. The process checks for mismatches across AGENTS.md guidance, rewrites frontmatter and body text, and produces an alignment report to guide reviewers and maintainers.

What are the limitations of automating SKILL.md alignment for codebase conventions?

Automating SKILL.md alignment focuses on rewriting frontmatter, body terminology, Key Files, and Related Skills. While it outputs updated files and an alignment report, human reviewers and maintainers must still validate the changes before finalizing the repository conventions.