Skip to main content

help-me

The developer wants to discover platform capabilities.

Step 1 — locate the index​

Find docs/capabilities.md to use as the source of truth. In order:

  1. The cwd repo's own docs/capabilities.md if it exists.
  2. The bewith plugin's copy at ~/.claude/plugins/cache/bewith/docs/capabilities.md.
  3. Fail clearly: tell the developer the plugin is not installed or the index has not been generated yet, and point them at pnpm capabilities in bewith-docs.

Step 2 — render based on $ARGUMENTS​

If $ARGUMENTS is empty → dump the full index. Format like a CLI --help:

BeWith platform — what you can ask me to do

Authoring (create / change platform content)
  /new-artifact          create a new agent, skill, command, rule, hook, or policy
  /share-rule            turn an insight into a team-rule PR for discussion

Code review & safety
  code-reviewer (agent)  pre-PR ten-point checklist
  block-edit-on-master   refuses edits while HEAD is on master
  …

Workflow & DoD
  process-guardian (agent)   Definition-of-Done gate
  …

…(continue grouped by tag, alphabetical within each group)…

One line per entry, all entries visible, no truncation. Compact column for the name + kind, short description in the second column. Read the actual tags from each artifact's frontmatter and use them as section headers — do not invent.

If $ARGUMENTS has content → filter:

  1. Treat the arguments as the developer's intent in free language.
  2. Match against artifact description and tags. Rank by relevance.
  3. Show only matches, up to ~6, with one line of context each:
For "review my migration before I push":

→ schema-migration (policy)
  Fires when a migration file is added or modified. Demands dry-run
  against a prod-shaped sandbox, data-loss static analysis, and an
  index-size review.

→ code-reviewer (agent)
  Pre-PR ten-point checklist; will flag schema-migration concerns
  among others.

→ process-guardian (agent)
  Definition-of-Done gate; blocks merge if migration checks are missing.

Want me to invoke one of these now?

End the match output with an offer to invoke the top match. If nothing matches, say so explicitly and offer /new-artifact for the "let's design something" path.

Step 3 — never bluff​

If you cannot find the index, do not synthesize entries from memory of past conversations. The capability list is the file. Say "I don't see docs/capabilities.md in this repo or the plugin cache" and stop.