s-hiraoku/harnesses-factory

Overview

This skill guides creating slash commands for Claude Code—reusable Markdown-based prompts with YAML configuration. It explains file structure, locations, frontmatter fields, dynamic features (arguments, file references, inline bash), naming conventions, and organization patterns. Use it to design, extend, and maintain reliable Claude Code commands for projects or plugins.

How this skill works

The skill inspects command Markdown files that include optional YAML frontmatter and a body with Claude instructions. It validates and recommends frontmatter fields like description, allowed-tools, model, and argument-hint, and it shows how to reference files, use positional arguments, and run inline bash to capture context. It also maps file locations to command scopes and suggests naming and organization conventions for predictable CLI-style command names.

When to use it

• Creating a new Claude Code command for a project or plugin
• Designing command workflows that accept arguments and reference project files
• Auditing or refactoring an existing set of commands for clarity and safety
• Restricting tool access or specifying models for particular commands
• Documenting expected arguments and help text for /help listings

Best practices

• Keep each command single-responsibility — one task per file
• Always include description and argument-hint in frontmatter
• Restrict tool access via allowed-tools to minimize risk
• Validate and sanitize inputs before processing arguments
• Use verb-noun file names and namespace folders when commands exceed a flat list

Example use cases

• review-pr.md that inspects a pull request diff and suggests changes using @src/main.ts references
• generate-tests.md that accepts a file path argument and produces unit tests based on its contents
• fix-issue.md that runs quick diagnostics with inline git commands and returns a remediation plan
• plugin-distributed commands placed under plugin/commands/ to ship functionality with an extension
• personal tools in ~/.claude/commands/ for repetitive local workflows