Menu

#136 docs: add install --skill explainer section to user guide

closed
nobody
None
2026-04-20
2026-04-16
Anonymous
No

Originally created by: kumaakh

Background

Suggested in PR [#133]. The user guide lists what install --skill writes but it's buried. Agents and new users hesitate to run installers they don't understand.

What to add

A short, visible section near the top of the install flow explaining:

  • What files get written and where (~/.apra-fleet/bin/, ~/.claude/skills/pm/, hooks, statusline config)
  • What it does NOT do (no system-level changes, no network calls, no background services)
  • How to uninstall / what to delete if you want to remove it

Needs to be verified against actual installer behavior before writing — don't document from assumption.

Related

Tickets: #133
Tickets: #139
Tickets: #143

Discussion

  • Anonymous

    Anonymous - 2026-04-16

    Originally posted by: kumaakh

    Blocked on [#139] — once the --skill all/pm/fleet/none default change lands, the explainer section should document the new options rather than the old --skill flag. Pick this up as part of the [#139] docs update pass.

     

    Related

    Tickets: #139

  • Anonymous

    Anonymous - 2026-04-20

    Originally posted by: kumaakh

    Fixed. README now has a dedicated --skill section (under the install accordion) listing all flag variants and what each installs. Verified present in main.

     
  • Anonymous

    Anonymous - 2026-04-20

    Ticket changed by: kumaakh

    • status: open --> closed
     

Log in to post a comment.

MongoDB Logo MongoDB