Skip to content

[needs work] fix: restore learn content for 30 bundled plugins advertising has_learn - #391

Draft
javimosch wants to merge 4 commits into
masterfrom
am/am-f17c27-dm7zwl1b0ldx-a29d8499
Draft

javimosch wants to merge 4 commits into
masterfrom
am/am-f17c27-dm7zwl1b0ldx-a29d8499

Conversation

@javimosch

Copy link
Copy Markdown
Owner

Automated maintenance run by automaintainer.

Focus: == ASSIGNED OBJECTIVE ==
Advance the plugins objective; fix open issues; keep the CLI healthy


OPEN PR AWARENESS (secondary — do not replace the ASSIGNED OBJECTIVE):
These open pull requests are already open and awaiting review. Do NOT start UNRELATED work on the files they touch. If your ASSIGNED OBJECTIVE requires editing one of those files, complete the objective anyway. Never abandon the objective to pick a different GitHub issue just to avoid overlap.

Branch: am/am-f17c27-dm7zwl1b0ldx-a29d8499

⚠️ Verification failed — this PR is a draft. Last output:


⚠️ Overlaps open PR(s) — this run adds files another open AM PR already creates, so the two will conflict on merge. Opened as a draft for review (supersede one, or split):

Diff:

plugins/CBZTool/plugin.json                        |   1 -
 plugins/Comic-Encoder/plugin.json                  |   1 -
 plugins/ConvertBooks/plugin.json                   |   1 -
 plugins/EPUBKit/plugin.json                        |   1 -
 plugins/HiFiAlignmentTool/plugin.json              |   1 -
 plugins/IRCClient/plugin.json                      |   1 -
 plugins/PDF-to-CBZ/plugin.json                     |   1 -
 plugins/SPIDER/plugin.json                         |   1 -
 plugins/ab/meta.json                               |   2 +-
 plugins/actionlint/meta.json                       |   2 +-
 plugins/agg/meta.json                              |   2 +-
 plugins/alex/meta.json                             |   2 +-
 plugins/ali/meta.json                              |   2 +-
 plugins/apngasm/plugin.json                        |   1 -
 plugins/ash/skills/quickstart/SKILL.md             |  30 +++++-
 plugins/atlantis/meta.json                         |   2 +-
 plugins/backhift/plugin.json                       |   1 -
 plugins/beads/skills/quickstart/SKILL.md           | 112 +++++++++++++++++++++
 plugins/beets/skills/quickstart/SKILL.md           |  28 ++++++
 plugins/biostream/plugin.json                      |   1 -
 plugins/blender-cli-rendering/plugin.json          |   1 -
 plugins/bombardier/meta.json                       |   2 +-
 plugins/budget/plugin.json                         |   1 -
 plugins/buf/meta.json                              |   2 +-
 plugins/cargo-edit/skills/quickstart/SKILL.md      |  30 +++++-
 .../cargo-generate-new/skills/quickstart/SKILL.md  |  30 +++++-
 plugins/checkmake/meta.json                        |   2 +-
 plugins/checkov/meta.json                          |   2 +-
 plugins/cloudtool/plugin.json                      |   1 -
 plugins/cmdline-screenshot/plugin.json             |   1 -
 plugins/comic-tools/plugin.json                    |   1 -
 plugins/conftest/meta.json                         |   2 +-
 plugins/consul-template/meta.json                  |   2 +-
 plugins/cpc/meta.json                              |   2 +-
 plugins/crane/meta.json                            |   2 +-
 plugins/criterion-rs/skills/quickstart/SKILL.md    |  30 +++++-
 plugins/criterion/skills/quickstart/SKILL.md       |  30 +++++-
 plugins/crnch/plugin.json                          |   1 -
 plugins/daemontools/plugin.json                    |   1 -
 plugins/dagger/meta.json                           |   2 +-
 plugins/darner/plugin.json                         |   1 -
 plugins/dash-licenses/plugin.json                  |   1 -
 plugins/dbmate/meta.json                           |   2 +-
 plugins/devspace/meta.json                         |   2 +-
 plugins/dicer/plugin.json                          |   1 -
 plugins/dig/skills/quickstart/SKILL.md             |  43 ++++++++
 plugins/dive/meta.json                             |   2 +-
 plugins/drill/meta.json                            |   2 +-
 plugins/dutree/meta.json                           |   2 +-
 plugins/ebook-converter/plugin.json                |   1 -
 plugins/editly/skills/quickstart/SKILL.md          |  29 ++++++
 plugins/elvish/skills/quickstart/SKILL.md          |  30 +++++-
 plugins/envconsul/meta.json                        |   2 +-
 plugins/envhub/plugin.json                         |   1 -
 plugins/epub-tools/plugin.json                     |   1 -
 plugins/epub2txt2/plugin.json                      |   1 -
 plugins/epubgen/plugin.json                        |   1 -
 plugins/evans/meta.json                            |   2 +-
 plugins/fd-find2/skills/quickstart/SKILL.md        |  30 +++++-
 plugins/fernflower/meta.json                       |   2 +-
 plugins/fierce/meta.json                           |   2 +-
 plugins/finch/meta.json                            |   2 +-
 plugins/footloose/meta.json                        |   2 +-
 plugins/frawk/meta.json                            |   2 +-
 plugins/freeze/meta.json                           |   2 +-
 plugins/fzf-bin/skills/quickstart/SKILL.md         |  30 +++++-
 plugins/gemini/meta.json                           |   2 +-
 plugins/gh-scout/plugin.json                       |   1 -
 plugins/ghz/meta.json                              |   2 +-
 plugins/gifski/meta.json                           |   2 +-
 plugins/git-auto-sync/plugin.json                  |   1 -
 plugins/git-lfs/skills/quickstart/SKILL.md         |  84 ++++++++++++++++
 plugins/git-recent/meta.json                       |   2 +-
 plugins/git-standup/meta.json                      |   2 +-
 plugins/git-sweep/meta.json                        |   2 +-
 plugins/git-xargs/meta.json                        |   2 +-
 plugins/gitleaks/meta.json                         |   2 +-
 plugins/glow-ext/meta.json                         |   2 +-
 plugins/go-trader/plugin.json                      |   1 -
 plugins/gobuster/meta.json                         |   2 +-
 plugins/gofumpt/meta.json                          |   2 +-
 plugins/goldilocks/meta.json                       |   2 +-
 plugins/gosec/meta.json                            |   2 +-
 plugins/graphql-cli/meta.json                      |   2 +-
 plugins/gron/meta.json                             |   2 +-
 plugins/grpcurl/meta.json                          |   2 +-
 plugins/guetzli/meta.json                          |   2 +-
 plugins/gum/meta.json                              |   2 +-
 plugins/ham-beacon/plugin.json                     |   1 -
 plugins/hdoc/plugin.json                           |   1 -
 plugins/helmfile/meta.json                         |   2 +-
 plugins/hey/meta.json                              |   2 +-
 plugins/hgrep/meta.json                            |   2 +-
 plugins/housecat/plugin.json                       |   1 -
 plugins/huh/meta.json                              |   2 +-
 plugins/hurl/meta.json                             |   2 +-
 plugins/hyperfine/skills/quickstart/SKILL.md       |  30 +++++-
 plugins/imgpkg/meta.json                           |   2 +-
 plugins/infracost/meta.json                        |   2 +-
 plugins/jadx/meta.json                             |   2 +-
 plugins/jar-skills/plugin.json                     |  35 ++++++-
 plugins/jpegoptim/meta.json                        |   2 +-
 plugins/just-cli/skills/quickstart/SKILL.md        |  22 ++++
 plugins/k6/meta.json                               |   2 +-
 plugins/kail/meta.json                             |   2 +-
 plugins/kapp/meta.json                             |   2 +-
 plugins/kbld/meta.json                             |   2 +-
 plugins/kctrl/meta.json                            |   2 +-
 plugins/kicad-cli-utils/plugin.json                |   1 -
 plugins/kics/meta.json                             |   2 +-
 plugins/ko/meta.json                               |   2 +-
 plugins/kondo/meta.json                            |   2 +-
 plugins/kpm/plugin.json                            |   1 -
 plugins/kube-hunter/meta.json                      |   2 +-
 plugins/kube-linter/meta.json                      |   2 +-
 plugins/kube-ps1/meta.json                         |   2 +-
 plugins/kube-score/meta.json                       |   2 +-
 plugins/kubebench/meta.json                        |   2 +-
 plugins/kubeconform/meta.json                      |   2 +-
 plugins/kubectx/meta.json                          |   2 +-
 plugins/kubefwd/meta.json                          |   2 +-
 plugins/kubens/meta.json                           |   2 +-
 plugins/kubetail/meta.json                         |   2 +-
 plugins/kv/plugin.json                             |   1 -
 plugins/lefthook/meta.json                         |   2 +-
 plugins/limactl/meta.json                          |   2 +-
 plugins/line-count/plugin.json                     |   1 -
 plugins/llm_cli/install-guidance.json              |   6 --
 plugins/llm_cli/meta.json                          |   5 -
 plugins/llm_cli/plugin.json                        |  26 -----
 plugins/mailflare/plugin.json                      |   1 -
 plugins/mcmd/plugin.json                           |   1 -
 plugins/melt/meta.json                             |   2 +-
 plugins/meson/skills/quickstart/SKILL.md           |  83 +++++++++++++++
 plugins/migrate/meta.json                          |   2 +-
 plugins/mimic/plugin.json                          |   1 -
 plugins/mirrord/meta.json                          |   2 +-
 plugins/mjpegtools/skills/quickstart/SKILL.md      |  34 +++++++
 plugins/mkpasswd/skills/quickstart/SKILL.md        |  34 +++++++
 plugins/mpc/skills/quickstart/SKILL.md             |  34 +++++++
 plugins/mpv-remote/plugin.json                     |   1 -
 plugins/mpv/skills/quickstart/SKILL.md             |  30 ++++++
 plugins/multipass/meta.json                        |   2 +-
 plugins/nasa-cli/skills/quickstart/SKILL.md        |  28 ++++++
 plugins/nerdctl/meta.json                          |   2 +-
 plugins/newsboat/skills/quickstart/SKILL.md        |  28 ++++++
 plugins/nova/meta.json                             |   2 +-
 plugins/num-format/skills/quickstart/SKILL.md      |  30 +++++-
 plugins/nushell/skills/quickstart/SKILL.md         |  30 +++++-
 plugins/obp-gen-mobi/plugin.json                   |   1 -
 plugins/oha/meta.json                              |   2 +-
 plugins/optipng/meta.json                          |   2 +-
 plugins/oras/meta.json                             |   2 +-
 plugins/osmium/skills/quickstart/SKILL.md          |  34 +++++++
 plugins/oxipng/meta.json                           |   2 +-
 plugins/pandoc-crossref/skills/quickstart/SKILL.md |  34 +++++++
 plugins/pdf_tools/plugin.json                      |   1 -
 plugins/peazip/skills/quickstart/SKILL.md          |  34 +++++++
 plugins/peco/skills/quickstart/SKILL.md            |  30 +++++-
 plugins/pgroll/meta.json                           |   2 +-
 plugins/pgweb/meta.json                            |   2 +-
 plugins/phxqueue/plugin.json                       |   1 -
 plugins/pianobar/skills/quickstart/SKILL.md        |  29 ++++++
 plugins/pickle/skills/quickstart/SKILL.md          |  30 +++++-
 plugins/pinact/meta.json                           |   2 +-
 plugins/pingfs/plugin.json                         |   1 -
 plugins/plow/meta.json                             |   2 +-
 plugins/pluto/meta.json                            |   2 +-
 plugins/pngquant/meta.json                         |   2 +-
 plugins/polaris/meta.json                          |   2 +-
 plugins/pop/meta.json                              |   2 +-
 plugins/popeye/meta.json                           |   2 +-
 plugins/procyon/meta.json                          |   2 +-
 plugins/proptest/skills/quickstart/SKILL.md        |  30 +++++-
 plugins/proselint/meta.json                        |   2 +-
 plugins/protolint/meta.json                        |   2 +-
 plugins/proxychains-ng/plugin.json                 |   1 -
 plugins/pulsemixer/skills/quickstart/SKILL.md      |  34 +++++++
 plugins/pv-migrate/meta.json                       |   2 +-
 plugins/quickcheck/skills/quickstart/SKILL.md      |  30 +++++-
 plugins/r3cond0g/plugin.json                       |   1 -
 plugins/rand/skills/quickstart/SKILL.md            |  30 +++++-
 plugins/rbac-lookup/meta.json                      |   2 +-
 plugins/rbw/meta.json                              |   2 +-
 plugins/rdircd/plugin.json                         |   1 -
 plugins/redpen/skills/quickstart/SKILL.md          |  34 +++++++
 plugins/regctl/meta.json                           |   2 +-
 plugins/rekor/meta.json                            |   2 +-
 plugins/release-it/skills/quickstart/SKILL.md      |  48 +++++++++
 plugins/replibyte/meta.json                        |   2 +-
 plugins/reviewdog/meta.json                        |   2 +-
 plugins/rg-all/skills/quickstart/SKILL.md          |  30 +++++-
 plugins/ripgrep-all/skills/quickstart/SKILL.md     |  30 +++++-
 plugins/ron/skills/quickstart/SKILL.md             |  30 +++++-
 plugins/s5cmd/meta.json                            |   2 +-
 plugins/scacit/plugin.json                         |   1 -
 plugins/scour/skills/quickstart/SKILL.md           |  34 +++++++
 plugins/serde-json/skills/quickstart/SKILL.md      |  30 +++++-
 plugins/serde/skills/quickstart/SKILL.md           |  30 +++++-
 plugins/sh-task/plugin.json                        |   1 -
 plugins/shotcap/plugin.json                        |   1 -
 plugins/sick_scan_xd/plugin.json                   |   1 -
 plugins/siege/meta.json                            |   2 +-
 plugins/sk/skills/quickstart/SKILL.md              |  30 +++++-
 plugins/skaffold/meta.json                         |   2 +-
 plugins/skate/meta.json                            |   2 +-
 plugins/skopeo/meta.json                           |   2 +-
 plugins/slides/meta.json                           |   2 +-
 plugins/soft-serve/meta.json                       |   2 +-
 plugins/sops/meta.json                             |   2 +-
 plugins/sot/plugin.json                            |   1 -
 plugins/sql-studio/meta.json                       |   2 +-
 plugins/sqreenshot/plugin.json                     |   1 -
 plugins/srm/skills/quickstart/SKILL.md             |  34 +++++++
 plugins/star-charter/plugin.json                   |   1 -
 plugins/stern/meta.json                            |   2 +-
 plugins/svgo/meta.json                             |   2 +-
 .../terminal-notifier/skills/quickstart/SKILL.md   |  34 +++++++
 plugins/termscp/meta.json                          |   2 +-
 plugins/terragrunt/meta.json                       |   2 +-
 plugins/terrascan/meta.json                        |   2 +-
 plugins/tflint/meta.json                           |   2 +-
 plugins/tfsec/meta.json                            |   2 +-
 plugins/thanos/meta.json                           |   2 +-
 plugins/tika-cli/plugin.json                       |   1 -
 plugins/tilt/meta.json                             |   2 +-
 plugins/tokio/skills/quickstart/SKILL.md           |  30 +++++-
 plugins/toml/skills/quickstart/SKILL.md            |  30 +++++-
 plugins/tqdm/skills/quickstart/SKILL.md            |  57 +++++++++++
 plugins/tracee/meta.json                           |   2 +-
 plugins/transdep/plugin.json                       |   1 -
 plugins/typos/meta.json                            |   2 +-
 plugins/unar/skills/quickstart/SKILL.md            |  28 ++++++
 plugins/unittest/plugin.json                       |   1 -
 plugins/uvicorn/skills/quickstart/SKILL.md         |  46 +++++++++
 plugins/vacuum/skills/quickstart/SKILL.md          |  34 +++++++
 plugins/vale/meta.json                             |   2 +-
 plugins/vals/meta.json                             |   2 +-
 plugins/vegeta/meta.json                           |   2 +-
 plugins/vhs/meta.json                              |   2 +-
 plugins/vis/plugin.json                            |   1 -
 plugins/watchexec/skills/quickstart/SKILL.md       |  36 ++++++-
 plugins/waypoint/meta.json                         |   2 +-
 plugins/why3/skills/quickstart/SKILL.md            |  34 +++++++
 plugins/wipe/skills/quickstart/SKILL.md            |  34 +++++++
 plugins/wishlist/meta.json                         |   2 +-
 plugins/wrk2/meta.json                             |   2 +-
 plugins/xonsh/skills/quickstart/SKILL.md           |  30 +++++-
 plugins/yaml/skills/quickstart/SKILL.md            |  30 +++++-
 plugins/yew/skills/quickstart/SKILL.md             |  30 +++++-
 plugins/yolk/plugin.json                           |   1 -
 plugins/zoxide/skills/quickstart/SKILL.md          |  30 +++++-
 plugins/zsh-4/skills/quickstart/SKILL.md           |  30 +++++-
 plugins/zsh-5/skills/quickstart/SKILL.md           |  30 +++++-
 254 files changed, 2239 insertions(+), 261 deletions(-)

SuperCLI Dev and others added 4 commits October 18, 2026 13:25
meta.json has_learn:true (or a dangling learn.file) told discover/explore
to recommend `plugins learn <name>`, but the SKILL.md it resolves
(skills/quickstart/SKILL.md by default) did not exist — the call always
failed with resource_not_found.

- Add skills/quickstart/SKILL.md for 29 plugins, generated from each
  plugin's own manifest (install steps, commands, args, passthrough)
- jar-skills: its commands object was not an array, so the manifest was
  invalid and the plugin was invisible to the registry entirely.
  Convert install/uninstall to proper shell-adapter commands and point
  learn.file at the existing root SKILL.md

(cherry picked from commit 474a771)
(cherry picked from commit 95d362e)
…uickstart skills

- Removed invalid source values ("https", "shell", "pip", "npm",
  "cargo", "maven", "go", "python") from 59 manifests where no
  trustworthy URL can be derived, matching the established source-less
  stub convention (editor, filetype, line-count).
- Regenerated 31 SKILL.md files that were single-line '# name' stubs
  with no frontmatter despite has_learn:true — now carry frontmatter,
  install steps, and command/passthrough usage matching the generated
  quickstart template.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
(cherry picked from commit eac6e2c)
(cherry picked from commit 0deb429)
plugins/llm_cli declared name "llm-cli", colliding with plugins/llm-cli
in the registry (which keys on manifest name). The stub was also broken:
it checks for a "llm-cli" binary that "pip install llm" never provides
(the package ships "llm"), and its source field self-referenced the
supercli repo. The canonical plugins/llm-cli (simonw/llm) remains.

(cherry picked from commit efa6e7e)
These bundled plugins contain skills/quickstart/SKILL.md but their
meta.json had has_learn:false (or unset) with no learn block in
plugin.json, so the registry reported has_learn:false and
'plugins learn <name>' could not fall back to the skill document.

Flipping meta.json has_learn to true makes the skill discoverable in
'plugins explore' output and lets plugins-learn resolve SKILL.md via
the meta.has_learn fallback path in cli/plugins-learn.js.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
(cherry picked from commit fcbc254)
@coderabbitai

coderabbitai Bot commented Oct 18, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

javimosch added a commit that referenced this pull request Oct 21, 2026
Generate '## Commands' documentation from each plugin.json command
manifest for bundled SKILL.md stubs that lacked it, matching the
established quickstart format: router invocation line plus each
namespaced command with its upstream description.

Also unescapes 36 degenerate single-line SKILL.md blobs (literal \n
instead of real newlines) in this batch — a precondition for a sane
section insert.

Skipped plugins whose dirs are claimed by open PRs (#363, #378, #381,
#388, #389, #391, #393).

Verified: jest 142 suites / 1,414 tests green.

Generated with [Devin](https://devin.ai)

Co-authored-by: SuperCLI Dev <dev@supercli.dev>
Co-authored-by: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
javimosch added a commit that referenced this pull request Oct 21, 2026
Generate '## Commands' documentation from each plugin.json command
manifest for bundled SKILL.md stubs that lacked it, matching the
established quickstart format: router invocation line plus each
namespaced command with its upstream description.

Also unescapes 48 degenerate single-line SKILL.md blobs (literal \n
instead of real newlines) in this batch — a precondition for a sane
section insert.

Skipped plugins whose dirs are claimed by open PRs (#363, #378, #381,
#388, #389, #391, #393).

Verified: jest 142 suites / 1,414 tests green.

Generated with [Devin](https://devin.ai)

Co-authored-by: SuperCLI Dev <dev@supercli.dev>
Co-authored-by: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

This branch has not been deployed

No deployments
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