StructKit Skills

June 28, 2026 · View on GitHub

Agent skills and workflow guidance for using StructKit safely and repeatably.

This repository currently ships one installable skill:

  • structkit-workflows — inspect, preview, generate, validate, and author StructKit structures.

Install

skills.sh / Skills CLI

This repository is laid out as a single root-level skill so Skills-compatible installers can install it directly:

npx skills add httpdss/structkit-skills

If your installer accepts raw SKILL.md URLs, use:

npx skills add https://raw.githubusercontent.com/httpdss/structkit-skills/main/SKILL.md

Hermes Agent

hermes skills install https://raw.githubusercontent.com/httpdss/structkit-skills/main/SKILL.md --name structkit-workflows

Or add the repository as a tap if your Hermes version supports GitHub skill taps:

hermes skills tap add httpdss/structkit-skills

What this skill optimizes for

  • Prefer StructKit-native tools/MCP when available.
  • Inspect structures and variables before generation.
  • Preview diffs before writing files.
  • Avoid overwrites unless explicitly requested.
  • Validate .struct.yaml files and generated outputs.
  • Keep custom structures reusable, composable, and CI-checked.

Repository layout

.
├── SKILL.md
├── references/
│   ├── overview.md
│   ├── safe-generation.md
│   ├── authoring-structures.md
│   ├── ci-validation.md
│   └── publishing-structures.md
├── templates/
│   ├── basic-structure.struct.yaml
│   └── repo-scaffold.struct.yaml
├── scripts/
│   └── validate_structkit_repo.py
└── .github/workflows/validate.yml

Validate locally

python scripts/validate_structkit_repo.py .

If structkit is installed, the validation script also runs structkit validate against template structures.

Versioning

Use semantic-ish versions in SKILL.md:

  • Patch: wording, examples, or reference corrections.
  • Minor: new references/templates or workflow sections.
  • Major: behavior-changing agent guidance.