Scaffold a new skill for hms-commander

VerifiedSafe

Guide to create a new skill following the existing hms-commander structure, including steps and conventions.

Sby Skills Guide Bot
DevelopmentBeginner
7/22/2026
Claude Code
#skill-authoring#scaffolding#templates#claude-code#conventions

Recommended for

Automated summary

Scaffolds a new skill under .claude/skills/ following the directory structure and SKILL.md template used in the hms-commander repository.

Strengths

  • Supplies a full SKILL.md template with frontmatter (name, description, trigger keywords) and required sections
  • States naming conventions explicitly: snake_case directories, uppercase SKILL.md, kebab-case example files
  • Covers updating the "Active Skills" table in .claude/INDEX.md
  • Points to existing skills (hms_execute_runs, hms_clone_components) as concrete references

Limitations

  • Tightly coupled to the hms-commander repo and its specific .claude/ layout
  • No validation, linting or testing of the generated skill, so content quality is left to the author
  • Assumes familiarity with referenced files (hec-hms rules, example notebooks) without describing their format
When to use it

Use it when adding a new skill to the hms-commander project while keeping the existing structure and index consistent.

When not to use it

Don't use it for skills outside the hms-commander ecosystem or for substantially rewriting the content of an existing skill.

Security analysis

Safe
Quality score75/100

The skill only instructs creating directories and writing template files for a new skill. It does not execute destructive commands, network operations, or handle secrets. The single mkdir command is benign and part of normal file scaffolding.

No concerns found

How this analysis is made

Examples

Scaffold a new skill
Create a new skill called hms_extract_results following the existing skill structure, with a SKILL.md from the template and register it in .claude/INDEX.md.
Scaffold with examples folder
Scaffold a skill named hms_configure_forecast under .claude/skills/, add an examples/ folder with a basic usage markdown file, and add the row to the Active Skills table.
Add and index a skill
I need a new skill for reading HMS project files — set up the directory and SKILL.md with trigger scenarios and workflows, then update the skills index.

Scaffold a new skill for hms-commander following the existing skill structure.

Skill Structure

.claude/skills/{skill_name}/
├── SKILL.md          # Main skill document (required)
├── examples/         # Working code examples (optional)
│   └── *.md
└── reference/        # Detailed API docs (optional)
    └── *.md

Step 1: Create Skill Directory

mkdir .claude/skills/{skill_name}

Step 2: Create SKILL.md

Use this template (see hms_execute_runs/SKILL.md for a full example):

---
name: {skill_name}
description: |
  One paragraph description of what this skill does.
  Trigger keywords: key, terms, that, invoke, this, skill.
---

# {Skill Title}

## Quick Start

Minimal working example to accomplish the core task.

## Primary Sources

**Code (Authoritative API)**:
- `hms_commander/{MainClass}.py` — Complete docstrings

**Examples (Working Demonstrations)**:
- `examples/{NN_notebook}.ipynb` — Cells X-Y

**Rules (Patterns & Decisions)**:
- `.claude/rules/hec-hms/{relevant-rule}.md`

## When to Use This Skill

**Trigger Scenarios**:
- User says "..."
- User mentions "..."

## Core Capabilities

### Capability 1
Pattern description.

## Common Workflows

### Workflow 1: Title
```python
# Code example

Troubleshooting

Common issues and solutions.

Integration Points

Before this skill: What to do first After this skill: What to do next

Related Skills

  • other_skill — Description

## Step 3: Add Examples (Optional)

Create `examples/` with markdown files showing real usage patterns.

## Step 4: Update INDEX.md

Add the new skill to `.claude/INDEX.md` "Active Skills" table:

```markdown
| **{skill_name}/** | Purpose description | trigger, keywords, here |

Skill Naming Conventions

  • Directory name: snake_case (e.g., hms_execute_runs)
  • Main file: SKILL.md (always uppercase)
  • Examples: kebab-case.md (e.g., basic-run.md)

Reference

  • Example full skill: .claude/skills/hms_execute_runs/SKILL.md
  • Simpler skill: .claude/skills/hms_clone_components/SKILL.md
  • Index: .claude/INDEX.md "Skills" section

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/scaffold-a-new-skill-for-hms-commander-mrwakdwg/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/scaffold-a-new-skill-for-hms-commander-mrwakdwg' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/scaffold-a-new-skill-for-hms-commander-mrwakdwg/download' --output '.skill-downloads/scaffold-a-new-skill-for-hms-commander-mrwakdwg/SKILL.md.part' && mv '.skill-downloads/scaffold-a-new-skill-for-hms-commander-mrwakdwg/SKILL.md.part' '.skill-downloads/scaffold-a-new-skill-for-hms-commander-mrwakdwg/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

This file does not provide a usable name/description header for this native procedure. It remains available to download and inspect; use the manual method below.

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/scaffold-a-new-skill-for-hms-commander-mrwakdwg/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills