nyxora-agent-skill-authoring

Author and validate in-repo SKILL.md files with frontmatter rules and structure conventions.

5|2|Updated May 26, 2026
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill nyxora-agent-skill-authoring-perasyudha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nyxora-agent-skill-authoring
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/software-development/nyxora-agent-skill-authoring
Command: npx skills add https://github.com/perasyudha/Nyxora --skill nyxora-agent-skill-authoring-perasyudha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a SKILL.md that passes the Nyxora agent validator and matches peer conventions is error-prone: frontmatter must start at byte zero, descriptions have length caps, and the wrong creation tool writes to the wrong directory. This Skill encodes the exact validator rules, size limits, and peer-matched structure so new in-repo skills validate on the first commit. ## Core Features & Use Cases - Validator-Accurate Rules: Documents the hard requirements from skill_manager_tool.py, including the 1024-character description cap, 100,000-character file limit, and frontmatter parsing constraints. - Peer-Matched Structure Template: Provides the standard section layout (Overview, When to Use, Common Pitfalls, Verification Checklist) used by every skill under skills/software-development/. - Writing Quality Principles: Eight checks for process predictability, completion criteria, duplication pruning, and avoiding no-op prose. - Use Case: You need to commit a new reusable workflow skill into the repo. Follow the workflow to survey peers, draft with write_file, validate the YAML frontmatter locally, and commit on the active branch. ## Quick Start Create a new in-repo skill named deploy-checklist under the devops category following the nyxora-agent-skill-authoring conventions and validate its frontmatter.

Frequently Asked Questions about nyxora-agent-skill-authoring

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

FAQPage Schema
How do I create a SKILL.md file in a repository?

Write the file to skills/<category>/<name>/SKILL.md using write_file, with YAML frontmatter starting at byte zero containing name and description fields. Then validate the frontmatter locally and commit with git add on the active branch.

What frontmatter fields are required in a SKILL.md?

The validator requires only name and description, with description capped at 1024 characters. Peer skills also include version, author, license, and a metadata block with tags and related_skills, which are not enforced but expected by convention.

Why does skill_manage create fail for in-repo skills?

The skill_manage create action writes to the user-local ~/.nyxora/skills/ directory, not the repository tree. For in-repo skills, use write_file to place the SKILL.md under skills/<category>/<name>/ and commit it with git.

What is the maximum size for a SKILL.md file?

The validator enforces a 100,000-character limit on the full file and 1,024 characters on the description. Peer skills typically run 8,000-14,000 characters; larger content should be split into references/ files linked from the body.

Why doesn't my new skill appear in the current session?

The skill loader initializes at session start and caches the skill list, so newly committed skills are invisible to skill_view and skills_list until a new session begins. This is expected behavior, not a bug.