Distribute harden across agent skill marketplaces

[mickeylorenzini]

Summary

Make harden discoverable and installable across all major agent skill marketplaces and registries. Harden is an Agent Skill (SKILL.md standard), not a Claude Code Plugin — this targets the skill distribution ecosystem specifically.

Motivation

Harden currently works with Claude Code, Codex CLI, and Gemini CLI but requires manual installation. Cross-marketplace distribution makes it discoverable via CLI tools (npx skills add, skillkit install) and web directories, lowering the barrier to adoption.

Scope

Phase 1: Repo Structure Updates

1. SKILL.md frontmatter — Add/verify YAML frontmatter with name, description, license fields (required by Vercel Skills CLI and all SKILL.md-based marketplaces)
2. GitHub repo topics — Add discovery tags: agent-skills, claude-code, skill-md, skillsmp, claude-skills, codex-cli, gemini-cli
3. Cross-platform compatibility — Verify repo structure is valid for all targets (Vercel Skills CLI, SkillKit, SkillsMP, SkillHub, LobeHub, Claude Code Templates, awesome lists)
4. README Installation section — Document all install methods (Vercel Skills CLI, SkillKit, LobeHub CLI, manual)

Phase 2: Marketplace Submissions

Tier 1 — Auto-discoverable (verify after Phase 1):

• Vercel Skills CLI (skills.sh)
• SkillKit (skillkit.sh)
• SkillsMP (skillsmp.com) — requires 2+ GitHub stars
• SkillHub (skillhub.club)

Tier 2 — PR submissions (draft and submit):

• Claude Code Templates (davila7/claude-code-templates)
• travisvn/awesome-claude-skills
• ComposioHQ/awesome-claude-skills
• VoltAgent/awesome-agent-skills

Tier 3 — Web/CLI submissions:

• LobeHub (lobehub.com/skills) — web form submission
• Anthropic Plugin Directory — flagged as future opportunity (requires plugin wrapper)

Constraints

• Do NOT modify SKILL.md body content — only frontmatter
• Do NOT create .claude-plugin/ infrastructure — harden is a skill, not a plugin
• Keep changes minimal — harden's value is "one file, install in 30 seconds"
• Flag any cross-marketplace structural conflicts

Likely Affected Files/Modules

• SKILL.md (frontmatter only)
• README.md (installation section)
• GitHub repo settings (topic tags)

Acceptance Criteria

• SKILL.md has valid YAML frontmatter with name, description, license
• GitHub repo topics include required discovery tags
• npx skills add mickeylorenzini/harden --list shows harden as available
• README includes multi-method installation section
• Tier 1 auto-discovery verified or blockers identified
• Tier 2 PR drafts prepared with exact content
• Tier 3 submission content prepared

[mickeylorenzini]

Phase 1 research findings:

• Codex CLI path: unconfirmed — official OpenAI docs say ~/.agents/skills/, third-party sources say ~/.codex/skills/. Both may work depending on version. README will use qualified language.
• Gemini CLI path: confirmed — ~/.gemini/skills/ is correct. ~/.agents/skills/ also works as a cross-platform alias.
• claude.ai upload flow: confirmed — Settings → Capabilities → Skills → '+' button → 'Upload a skill'. Requires Pro/Max/Team/Enterprise. Skill must be ZIP.
• SkillKit flags: skillkit install <source> is the install command. No documented --dry-run flag.
• Vercel Skills CLI flags: --list (-l), --global (-g), --agent (-a), --skill (-s), --yes (-y) confirmed.
• License format: MIT (SPDX) confirmed per agentskills.io spec.
• Cross-platform note: both Codex and Gemini CLI are converging on ~/.agents/skills/ as forward-compatible path.

[mickeylorenzini]

Phase 1 verification results:

• SKILL.md frontmatter: license: MIT field added
• GitHub topics: skill-md, skillsmp added (10 total)
• README: install section updated with CLI + chat methods
• Vercel Skills CLI: ✅ npx skills add mickeylorenzini/harden --list discovers harden correctly, parses full description from frontmatter
• SkillKit: skillkit install has a packaging bug (missing aiofiles dependency in v0.4.0) — install command format is correct per their docs, blocked on upstream fix
• SkillsMP: platform returned 403 — awaiting next check
• SkillHub: not yet indexed in featured sections — awaiting next scrape cycle

All repo-side changes are complete. Platform indexing delays do not block Phase 1 completion.

[mickeylorenzini]

SkillsMP update: harden confirmed visible on skillsmp.com. 3 of 4 Tier 1 platforms now confirmed (Vercel Skills CLI, SkillsMP, plus GitHub topics for discovery). SkillHub and SkillKit remain outstanding — tracked in follow-up issue.

[mickeylorenzini]

Phase 1 — Complete ✅

All repo-side changes shipped. Tier 1 status:

• Vercel Skills CLI: ✅ live (npx skills add mickeylorenzini/harden)
• SkillsMP: ✅ live (visible on skillsmp.com)
• SkillKit: ⚠️ blocked by upstream bug (tracked in Follow up: SkillKit and SkillHub Tier 1 visibility #11)
• SkillHub: ⚠️ not yet indexed (tracked in Follow up: SkillKit and SkillHub Tier 1 visibility #11)

Phase 2 — Next Step

Needs brainstorming → plan before execution. Scope from this issue:

Tier 2 — PR submissions:

• davila7/claude-code-templates
• travisvn/awesome-claude-skills
• ComposioHQ/awesome-claude-skills
• VoltAgent/awesome-agent-skills

Tier 3 — Web/CLI submissions:

• LobeHub (lobehub.com/skills)

Each Tier 2 target needs research into their contribution format, then a PR drafted to match. Start a new session with brainstorming → writing-plans for Phase 2.