Feature Track supports both Codex plugin marketplace installation and portable GitHub installation through npx skills add. Both paths deliver the same Feature Tracking workflow, while the Python CLI remains the engine for init, add, validate, and legacy adapter installation workflows.
- Product intro and install path: README
- Plugin manifest: plugin.json
- Canonical portable skill: SKILL.md
- Bundled skill: SKILL.md
- Neutral spec: feature-track-spec.md
- Skills CLI install design: design
- Skills CLI implementation plan: plan
- README install simplification design: design
- README install simplification plan: plan
- Codex users can install Feature Track through the repo marketplace once the repository is published or cloned locally.
- Agent Skills CLI users can install the portable skill from the GitHub repository URL with
npx skills add. - The README presents
npx skills add JunsW/feature-trackas the single primary Quick Start command and keeps other supported paths concise. - The canonical package lives at the standard discovery path
skills/feature-tracking/. - The plugin bundles the
feature-trackingskill and its local references/scripts. - The CLI remains available for direct
init,add,validate,install codex, andinstall claude-codeworkflows. - Claude Code support remains a project adapter that creates
.claude/commandsand CLAUDE guidance.
- Package the Codex path as a single-skill plugin first.
- Keep MCP servers, apps, and hooks out of v0.1 because the current value is workflow guidance and Markdown memory, not external tool access or lifecycle enforcement.
- Keep the plugin self-contained by copying the Codex skill under
plugins/feature-track/skills/feature-tracking/. - Keep
skills/feature-tracking/as the canonical portable package and test that the plugin copy remains identical. - Use a repo marketplace at
.agents/plugins/marketplace.jsonso installation can work through Codex plugin marketplace flows.
- Public install docs need the final GitHub owner/repository path before release.
- The plugin skill copy can drift from
skills/feature-tracking/; package-parity tests must remain part of verification. - Hook-based enforcement may be useful later, but adding it now would overstate the v0.1 behavior.
- 2026-07-16: Collapsed secondary installation options in the README so the primary
npx skills addpath remains visually dominant. - 2026-07-16: Fixed CI compilation to follow the canonical skill validator after the standard-directory migration and added regression coverage for workflow paths.
- 2026-07-16: Simplified README installation guidance around one primary
npx skills addcommand and compact alternatives. - 2026-07-16: Added standard Agent Skills discovery layout, GitHub URL installation guidance, adapter coverage, and plugin package-parity tests.
- 2026-07-06: Added Codex plugin wrapper, repo marketplace metadata, and plugin-first README positioning.