plugin-slash-command

Generate Navigator slash command markdown files following project conventions.

232|12|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/qf-studio/navigator --skill plugin-slash-command-qf-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-slash-command
Source: https://github.com/qf-studio/navigator/tree/main/skills/plugin-slash-command
Command: npx skills add https://github.com/qf-studio/navigator --skill plugin-slash-command-qf-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating new slash commands for the Navigator Claude Code plugin manually leads to inconsistent structure, invalid YAML frontmatter, and mismatched tone across command files. This Skill automates command generation so every new /nav: command follows established conventions without manual formatting work. ## Core Features & Use Cases - Convention-Based Generation: Produces command markdown files with proper YAML frontmatter, section structure, and Navigator tone based on simple, medium, or complex complexity levels. - Built-In Validation: Validates generated commands for frontmatter correctness, heading hierarchy, code block formatting, 2nd-person style, and emoji usage via command_validator.py. - Pattern Matching: Analyzes existing commands to extract structure, tone, and example patterns before generating new ones. - Use Case: When you say "add a slash command for showing Navigator version", the Skill gathers requirements, generates commands/version.md, validates it, and shows a usage summary. ## Quick Start Ask the assistant to create a new Navigator slash command by describing its name and purpose, for example: add a slash command for archiving old task documentation.

Frequently Asked Questions about plugin-slash-command

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

FAQPage Schema
How do I create a new slash command for a Claude Code plugin?

Describe the command name, purpose, and complexity level, and the Skill generates a markdown file in the commands/ directory with valid YAML frontmatter, structured sections, usage examples, and troubleshooting content following Navigator conventions.

What naming conventions apply to slash command files?

Command names must be kebab-case (lowercase letters, numbers, and hyphens), under 50 characters, and cannot use reserved names like help, clear, or reset. The file is saved as commands/[command-name].md.

How is a generated slash command validated?

The command_validator.py script checks YAML frontmatter for a description field, verifies heading hierarchy and closed code blocks, enforces 2nd-person perspective, limits emoji count, and confirms a bold closing statement exists.

What is the difference between simple, medium, and complex commands?

Simple commands contain a description, usage, and basic troubleshooting. Medium commands add execution steps, more scenarios, and best practices. Complex commands include pre-flight checks, multi-step execution plans, validation steps, and edge case handling.

Why does command validation fail on my generated file?

Common causes include missing or empty description fields in frontmatter, unclosed code blocks, heading level skips, first-person phrasing instead of 2nd person, or a missing bold closing statement at the end of the file.