Skip to content

Native skills install/update (agent‑driven, full library, safe migration) #394

@aryeko

Description

@aryeko

Is your feature request related to a problem? Please describe

TL;DR: Move Superpowers' Codex install/update flow to the native Agent Skills open‑spec path (user‑scope, full library, agent‑driven) with safe migration from the current bootstrap flow. This reduces maintenance burden, improves reliability, and keeps the always‑on gatekeeper via AGENTS.md.

Motivation / Justification

  • Current Codex integration relies on a bespoke bootstrap CLI + repo clone, creating a non‑native experience and added maintenance.
  • Codex and other major platforms now support the open spec and standard discovery locations.
  • A native install path reduces per‑session overhead and install friction, and makes updates/uninstall deterministic.
  • Standardizing on the open‑spec path should benefit Gemini support as well (Gemini CLI Extension: Research Findings and Implementation Status #128).

Describe the solution you'd like

Proposal (high‑level)

  • Adopt the standard open‑spec skill discovery path for Codex (user‑scope).
  • Keep installation agent‑driven by default, with an optional manual path.
  • Require full‑library installs (no partial installs).
  • Ensure safe updates/uninstall and removal of stale Superpowers artifacts.
  • Keep always‑on gatekeeping via AGENTS.md; treat using-superpowers as a rule (always in context).

Describe alternatives you've considered

  • Native‑only with fast deprecation of the bootstrap path.
  • Keep bootstrap as primary (status quo, higher maintenance).

Recommended: Hybrid transition — native path primary, bootstrap path deprecated with a sunset.

Additional context

Metadata

Metadata

Assignees

No one assigned

    Labels

    codexIssues related to OpenAI Codex supportenhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions