https://github.com/httpdss/structkit-skills
Agent skills and workflows for using StructKit safely and repeatably.
https://github.com/httpdss/structkit-skills
ai-agents ai-assistant ai-tools hermes-skill skills skills-sh structkit
Last synced: 28 days ago
JSON representation
Agent skills and workflows for using StructKit safely and repeatably.
- Host: GitHub
- URL: https://github.com/httpdss/structkit-skills
- Owner: httpdss
- Created: 2026-06-28T17:45:56.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-28T18:11:30.000Z (about 1 month ago)
- Last Synced: 2026-06-28T19:23:44.798Z (about 1 month ago)
- Topics: ai-agents, ai-assistant, ai-tools, hermes-skill, skills, skills-sh, structkit
- Language: Python
- Homepage: https://structkit.app/docs/structkit-skill
- Size: 15.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# StructKit Skills
Agent skills and workflow guidance for using [StructKit](https://github.com/httpdss/structkit) safely and repeatably.
This repository currently ships one installable skill:
- [`structkit-workflows`](./SKILL.md) — 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:
```bash
npx skills add httpdss/structkit-skills
```
If your installer accepts raw `SKILL.md` URLs, use:
```bash
npx skills add https://raw.githubusercontent.com/httpdss/structkit-skills/main/SKILL.md
```
### Hermes Agent
```bash
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:
```bash
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
```text
.
├── 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
```bash
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.