Skip to content

feat: viral-readiness pass — plugin manifest, AGENTS.md, llms.txt, examples, issue templates - #2

Merged
Aboudjem merged 3 commits into
mainfrom
supernova/viral-readiness
May 30, 2026
Merged

Aboudjem merged 3 commits into
mainfrom
supernova/viral-readiness

Conversation

@Aboudjem

Copy link
Copy Markdown
Owner

Summary

  • Score: 60 → 92 (Tier 3 → Tier 1) — only remaining gap is has_tests (pure-Markdown skill, no executable code; not faked)
  • Adds .claude-plugin/plugin.json + marketplace.json so the skill is installable via claude plugin marketplace add Aboudjem/humanizer-skill
  • Adds AGENTS.md (universal harness context, auto-discovered by 23 AI editors: Cursor, Copilot, Codex CLI, Windsurf, Gemini CLI, etc.)
  • Adds llms.txt (LLM-citeability / RAG discoverability, H1 + blockquote + keyword-first sections)
  • Adds examples/blog-post/ — annotated before/after reference case (score 87 → 11, 11 patterns documented)
  • Adds .github/ISSUE_TEMPLATE/bug_report.md + feature_request.md
  • Adds docs/VIRAL-AUDIT.md — engine score/tier/gap report with honest has_tests note
  • Adds docs/LAUNCH-PLAN.md — June 2026 channel-sequenced launch plan (borrowed-reach-first, 13:00–16:00 UTC, r/ClaudeAI lead + X thread + dev.to)
  • Sets GitHub topics (claude-code, claude-code-plugin, humanizer, ai-writing, writing-tools) and keyword-first description (≤160 chars)

Files added

.claude-plugin/plugin.json
.claude-plugin/marketplace.json
AGENTS.md
llms.txt
examples/blog-post/before.md
examples/blog-post/after.md
.github/ISSUE_TEMPLATE/bug_report.md
.github/ISSUE_TEMPLATE/feature_request.md
docs/VIRAL-AUDIT.md
docs/LAUNCH-PLAN.md

Engine feedback (for iteration log)

  • Type detection (skill) and packaging recommendation (skill+plugin) are correct.
  • One candidate false gap: has_tests is flagged HIGH for a pure-Markdown skill with no executable code. The rubric should conditionally skip or downweight this signal when repoType === "skill", or substitute a skill-specific check (e.g. presence of annotated examples/). The examples/blog-post/ added here is the closest functional equivalent.
  • No other false gaps observed.

Test plan

  • Re-run node /Users/adamboudj/projects/supernova/server/cli.js /path/to/humanizer-skill --json — confirm score ≥ 85 (Tier 1)
  • Confirm claude plugin marketplace add Aboudjem/humanizer-skill resolves correctly
  • Verify AGENTS.md is picked up by Claude Code on fresh project load
  • Review docs/LAUNCH-PLAN.md before executing any launch steps

Aboudjem added 3 commits May 30, 2026 01:44
…amples, issue templates, docs

Adds all missing supernova-standard artifacts to lift score from 60 → 92 (Tier 3 → Tier 1):

- .claude-plugin/plugin.json + marketplace.json: installable as a Claude Code plugin
  via `claude plugin marketplace add Aboudjem/humanizer-skill`
- AGENTS.md: universal harness context (auto-discovered by 23 AI editors)
- llms.txt: LLM-citeability and RAG discoverability (H1 + blockquote + sections)
- examples/blog-post/before.md + after.md: annotated before/after reference case
  with 11 AI patterns flagged and score delta 87 → 11 documented
- .github/ISSUE_TEMPLATE/bug_report.md + feature_request.md
- docs/VIRAL-AUDIT.md: engine score/tier/gap report + honest note on has_tests gap
- docs/LAUNCH-PLAN.md: June 2026 channel-sequenced launch plan (borrowed-reach-first,
  13:00-16:00 UTC, r/ClaudeAI lead + X thread + dev.to, second-wave plan)

Only gap remaining: has_tests (pure-Markdown skill — no executable code to test).
- VIRAL-AUDIT.md: strip bold-header table cells, remove bold emphasis
  noise, flatten "honest note" subheading to plain prose, drop inline
  bold on every other phrase; casual dev voice throughout
- LAUNCH-PLAN.md: remove bold pillar callout, flatten section headers
  to plain English, cut "perfectly fits" and influencer filler, drop
  rule-of-three padding in borrowed-reach list, tighten second-wave
  bullet; no em dashes, no AI vocabulary
- social-preview.svg: 37 patterns -> 43 to match SKILL.md catalog
The plugin manifest (.claude-plugin/plugin.json + marketplace.json) is the
standard public location for a Claude Code plugin and is what
claudemarketplaces.com auto-crawls. It is not an internal/working dir like
.planning/.deep-research/.omc, so it must not fail the leak check.
@Aboudjem
Aboudjem marked this pull request as ready for review May 30, 2026 08:10
@Aboudjem
Aboudjem merged commit 5bfc2ae into main May 30, 2026
1 check passed
@Aboudjem
Aboudjem deleted the supernova/viral-readiness branch May 30, 2026 08:10
Aboudjem added a commit that referenced this pull request Jul 15, 2026
…amples, issue templates (#2)

* feat: viral-readiness pass — plugin manifest, AGENTS.md, llms.txt, examples, issue templates, docs

Adds all missing supernova-standard artifacts to lift score from 60 → 92 (Tier 3 → Tier 1):

- .claude-plugin/plugin.json + marketplace.json: installable as a Claude Code plugin
  via `claude plugin marketplace add Aboudjem/humanizer-skill`
- AGENTS.md: universal harness context (auto-discovered by 23 AI editors)
- llms.txt: LLM-citeability and RAG discoverability (H1 + blockquote + sections)
- examples/blog-post/before.md + after.md: annotated before/after reference case
  with 11 AI patterns flagged and score delta 87 → 11 documented
- .github/ISSUE_TEMPLATE/bug_report.md + feature_request.md
- docs/VIRAL-AUDIT.md: engine score/tier/gap report + honest note on has_tests gap
- docs/LAUNCH-PLAN.md: June 2026 channel-sequenced launch plan (borrowed-reach-first,
  13:00-16:00 UTC, r/ClaudeAI lead + X thread + dev.to, second-wave plan)

Only gap remaining: has_tests (pure-Markdown skill — no executable code to test).

* ux-polish: humanize docs, fix SVG pattern count

- VIRAL-AUDIT.md: strip bold-header table cells, remove bold emphasis
  noise, flatten "honest note" subheading to plain prose, drop inline
  bold on every other phrase; casual dev voice throughout
- LAUNCH-PLAN.md: remove bold pillar callout, flatten section headers
  to plain English, cut "perfectly fits" and influencer filler, drop
  rule-of-three padding in borrowed-reach list, tighten second-wave
  bullet; no em dashes, no AI vocabulary
- social-preview.svg: 37 patterns -> 43 to match SKILL.md catalog

* ci: stop flagging public .claude-plugin/ manifest as internal

The plugin manifest (.claude-plugin/plugin.json + marketplace.json) is the
standard public location for a Claude Code plugin and is what
claudemarketplaces.com auto-crawls. It is not an internal/working dir like
.planning/.deep-research/.omc, so it must not fail the leak check.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant