Three more learnings from alirezarezvani/claude-skills, applied:
1. SkillCheck validator (scripts/skillcheck.mjs) — validates every SKILL.md
against the authoring standard (frontmatter, name/folder match, trigger +
produces clauses, required headings) plus tier referential integrity.
Errors fail CI; --strict fails on warnings too. New skillcheck.yml workflow
and a SkillCheck status badge in the README. Current: 0 errors / 14 advisory
warnings across 172 skills.
2. Cursor export platform — build-exports.mjs now generates
exports/cursor/<bundle>/<skill>/<skill>.mdc rule files. The PLATFORMS
registry now supports per-skill filenames (file as a function).
3. Per-agent installers — scripts/install.sh unifies install for
claude/hermes/codex/openclaw/cursor (--link, --target, --dry-run, --list).
Curl-able one-liners codex-install.sh, openclaw-install.sh, and
cursor-install.sh clone the library and install in a single command.
README documents the one-line installs and Cursor exports; CHANGELOG and the
authoring standard updated.
Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px
Co-authored-by: Claude <noreply@anthropic.com>
Learnings applied from alirezarezvani/claude-skills: native SKILL.md agents
(Hermes, Vibe) install the files directly — no conversion — so support is a
sync script, not regenerated copies.
- scripts/sync-hermes-skills.py: stdlib installer that places skills/ into
~/.hermes/skills/ (copy or --link symlink, --flat, --dry-run). Hermes reads
the same open SKILL.md standard and auto-discovers by description.
- README rebrand: title, tagline, intro, and a "works with" platforms badge now
cover Claude, ChatGPT, Gemini, and Hermes. Works-With table splits native
SKILL.md agents (Claude Code, Hermes) from paste-in chat LLMs. Repo name,
marketplace ID, and install commands intentionally unchanged.
- Version bump to v16.0.0 (Multi-Platform). Note: v15.0.0 was already published
(Skill Playground), so this release is v16.0.0; the changelog now also records
v15.0.0 in its history. Updated README badge/What's-New, CHANGELOG, SECURITY,
and playground tagline/meta.
Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px
Co-authored-by: Claude <noreply@anthropic.com>
Proves the PLATFORMS registry extends cleanly: adds Gemini (Gem instructions)
alongside ChatGPT, generated from the same SKILL.md source.
- scripts/build-exports.mjs: register `gemini` -> exports/gemini/<bundle>/<skill>/
GEM_INSTRUCTIONS.md (body + a one-line role primer from the description).
- Fix: the root exports/README.md now always lists every registered platform,
so `--platform x` no longer drops the others from the overview.
- exports/gemini/: 172 generated Gem instruction files + index.
- README "Ready-to-use exports" and CHANGELOG now list Gemini.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px
Make the library multi-platform without duplicating content. Each
skills/<name>/SKILL.md body remains the single source of truth; a new
generator renders platform-ready exports from it.
- scripts/build-exports.mjs — dependency-free Node generator with a PLATFORMS
registry so new platforms (Gemini, Cursor, …) are a few lines. Ships ChatGPT
exports at exports/chatgpt/<bundle>/<skill>/SYSTEM_PROMPT.md (172 skills),
plus generated index READMEs. Supports --platform and --check.
- exports/ — generated ChatGPT system prompts, ready to paste into a Custom GPT.
- .github/workflows/check-generated.yml — fails a PR if exports or
web/skills.json drift from the source skills.
- README "Works With" now documents the ready-to-use exports and regen command.
- CHANGELOG + SKILL-AUTHORING-STANDARD note the generated artifacts.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px
Five improvements to position the library as a serious engineering project:
1. Cross-tool compatibility — new README "Works With" section honestly
documenting where skills run (Claude Code natively; SKILL.md bodies
port to other agents and chat LLMs as system prompts).
2. Python helper scripts (stdlib-only) for the three strongest skills:
- sprint-planning: capacity_calculator.py (recommended commitment)
- rice-prioritisation: rice_calculator.py (ranks, flags quick wins/moonshots)
- cs-health-scorecard: health_score.py (weighted total + RAG)
Each is wired into its SKILL.md and synced to the plugin copies.
3. Explicit skill tiering — TIERS.md + README section marking 46
Production-Ready skills and calling out Experimental (external-dependency)
ones; everything else is Stable.
4. Repository hygiene — new CHANGELOG.md (Keep a Changelog format) and
SKILL-AUTHORING-STANDARD.md; refreshed SECURITY.md version table and
helper-script disclosure; added .gitignore.
5. Related Projects — README section linking to alirezarezvani/claude-skills
and the major awesome-claude-skills / awesome-claude-code lists.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px
mohitagw15856
Claude