From edba3b7e96fdfa2fc2f01f7e5a4009911fb1c9c8 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sun, 19 Apr 2026 12:20:05 +0000 Subject: [PATCH] docs: sync docs with catalog population in PR #7 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The discover catalog moved from empty stub to 7 curated entries. Update README and CONTRIBUTING to reflect current state: - README: add catalog workflow table under /sidekick:discover; mark Publishing step 1 done; remove stale "catalog intentionally empty" note - CONTRIBUTING: drop "stub pending curation" language; fix catalog entry template heading level (### → ##) to match actual catalog format Co-Authored-By: Claude Sonnet 4.6 --- CONTRIBUTING.md | 8 ++++---- README.md | 22 +++++++++++++++++----- 2 files changed, 21 insertions(+), 9 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e348af4..f1d074e 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -40,9 +40,9 @@ skills/ ## What to contribute -### Adding catalog entries (highest priority) +### Adding catalog entries -The catalog at `skills/discover/catalog.md` is the core product value of sidekick. It is currently a stub pending curation. Before adding an entry: +The catalog at `skills/discover/catalog.md` is the core product value of sidekick. It currently contains 7 curated entries. Before adding a new entry: 1. Find the workflow in the [`githubnext/agentics`](https://github.com/githubnext/agentics) catalog. 2. Install it locally with `gh aw add ` and verify it works end-to-end. @@ -51,7 +51,7 @@ The catalog at `skills/discover/catalog.md` is the core product value of sidekic Each entry must use the template defined in `catalog.md`: ```markdown -### +## - **Upstream source**: `` or URL - **One-line purpose**: @@ -60,7 +60,7 @@ Each entry must use the template defined in `catalog.md`: - **Auth requirement**: OAuth path / API-key path / either ``` -Quality over quantity. Aim for 5–8 entries you would personally recommend, not an exhaustive list. +Quality over quantity. Aim for entries you would personally recommend, not an exhaustive list. ### Adding a skill diff --git a/README.md b/README.md index 944f714..a58417d 100644 --- a/README.md +++ b/README.md @@ -65,6 +65,20 @@ Then inside Claude Code: Inspects your repo's shape (language, test presence, CI configuration, recent activity) using only local `git` and filesystem tools — no external API calls. Loads the curated [catalog](skills/discover/catalog.md) and recommends up to 3 workflows that fit, each with a one-sentence reason specific to your repo and an estimated setup friction level. Hands off directly to `/sidekick:install` once you pick one. +#### Available catalog workflows + +| Workflow | Purpose | Setup friction | +|---|---|---| +| [issue-triage](skills/discover/catalog.md#issue-triage) | Labels issues, detects spam, and posts analysis comments automatically | Low | +| [pr-nitpick-reviewer](skills/discover/catalog.md#pr-nitpick-reviewer) | On-demand style/best-practice review via `/nit` on any PR | Low | +| [markdown-linter](skills/discover/catalog.md#markdown-linter) | Runs Super Linter on Markdown on a weekday schedule; files issues for violations | Low | +| [pr-fix](skills/discover/catalog.md#pr-fix) | Analyzes CI failures and pushes a fix commit via `/pr-fix` | Medium | +| [weekly-issue-summary](skills/discover/catalog.md#weekly-issue-summary) | Posts a weekly Discussion with issue-activity trends and recommendations | Medium | +| [daily-malicious-code-scan](skills/discover/catalog.md#daily-malicious-code-scan) | Scans recent commits for secrets, obfuscation, and supply-chain red flags | Low | +| [daily-repo-status](skills/discover/catalog.md#daily-repo-status) | Creates a daily issue summarizing activity with productivity insights | Low | + +All catalog entries require Claude auth (OAuth or API-key). See [skills/install/auth.md](skills/install/auth.md) for the decision tree. + ### `/sidekick:install` Takes a workflow name (or prompts you to run `/sidekick:discover` first) and: @@ -135,8 +149,6 @@ Changes to `skills/*/SKILL.md` take effect on the next Claude Code session reloa Once v0.1 is scope-locked: -1. Fill in `skills/discover/catalog.md` with curated entries (5–8 workflows from the `githubnext/agentics` catalog) -2. Update `plugin.json` with the final author name and repository URL -3. Submit via `claude.ai/settings/plugins/submit` or `platform.claude.com/plugins/submit` - -> The catalog is intentionally empty until scope-lock — this prevents anchoring recommendations before curation is complete. +1. ~~Fill in `skills/discover/catalog.md` with curated entries~~ — catalog populated with 7 entries. +2. Update `plugin.json` with the final author name and repository URL. +3. Submit via `claude.ai/settings/plugins/submit` or `platform.claude.com/plugins/submit`.