Skip to content

v1.0.0 Portable skills

Choose a tag to compare

@napattan napattan released this 07 Sep 16:26
· 33 commits to main since this release

v1.0.0 Portable skills

First tagged public line of this suite. Same SKILL.md files on Claude Code, Grok, Gemini/Antigravity, Cursor, Codex, and similar loaders. IDE or CLI. Windows, macOS, and Linux.

Sister repo: mcp-bridges (QGIS, Rhino, Grasshopper, Illustrator, Figma).


Why this release exists

Earlier untagged main mixed host-specific APIs, a thesis-only doc auditor, and a /create-skill flow that wrote stubs or Gemini-only paths. v1.0.0 is the portable, publishable line: no one-machine paths, no baked-in project filenames, no required vendor tool names.


Skills in this tag

Skill Command What it does What it stops
BoostX /boostx Red gate, Ponytail short-diff ladder, dual-OS edits, green verification. Task classes: code (failing command), docs (stale-claim grep), audit (engine exit code). Uses host subagents/background tools if they exist; never requires a vendor API name. Speculative patches; fake unit tests on doc work; Antigravity-only instructions on other hosts
Create Skill /create-skill Discovers skill roots (project .agents / .grok or user ~/.claude / ~/.grok / ~/.gemini/config). Drafts YAML description, waits for approval, writes a full SKILL.md. Dual-OS directory create. No machine-user paths. Thin drafts; wrong folder; Gemini-only or Grok-only write paths
Update Doc /update-doc (1) Ground-truth delta from this chat. (2) Scan markdown and HTML in the current workspace. (3) Follow relations (symbols, metrics, status words, links). (4) 5-tier inner-to-outer sync. (5) Re-grep deprecated terms to zero. Optional: your own scripts/audit_docs.py. Stale claims; hardcoded file lists from someone else's repo
Publish Audit /publish-audit python scripts/audit_engine.py <dir> --platform generic|qgis|food4rhino|github. Secrets (masked), machine paths, .env / .ps1 / .sh / .toml. GitHub missing LICENSE = blocking. Food4Rhino missing .gha/.dll = blocking. README Published / LIVE / 1-click = advisory. Credential leaks; unescaped % in QGIS metadata; claiming PyPI/NPM without a profile
Publish QGIS /publish-qgis SemVer, metadata interpolation, single-root zip, Qt6 / QGIS 4 AST check, package slug ladder. Run after /publish-audit is green. Plugin portal zip rejections; Qt6 deprecations

Public status words (owned by /update-doc): LIVE, REGISTERED, PREPARED, IN PIPELINE, DRAFT.


Layout

agent-skills/
├── README.md
├── CHANGELOG.md
├── LICENSE
├── skills/
│   ├── boostx/SKILL.md
│   ├── create-skill/SKILL.md
│   ├── update-doc/SKILL.md
│   ├── publish-audit/SKILL.md + scripts/audit_engine.py
│   └── publish-qgis/SKILL.md + scripts/check_qt6.py, package_qgis.py
└── scripts/install.sh, install.ps1

Install

Clone skills/ into your host skill root (see README table). Or:

git clone --branch v1.0.0 https://github.com/napattan/agent-skills.git ~/.claude/skills
git clone --branch v1.0.0 https://github.com/napattan/agent-skills.git ~/.grok/skills
git clone --branch v1.0.0 https://github.com/napattan/agent-skills.git .agents/skills

Windows: scripts/install.ps1. POSIX: scripts/install.sh.


Not in this package

The old thesis HTML auditor (audit_workspace_docs.py with fixed layer counts) is not shipped. If your own repo needs extra checks, add scripts/audit_docs.py there. /update-doc will run it when present.


Related