feature-marker - Skill-first feature workflow for Claude, Codex, and Gemini

feature-marker is a portable LLM skill for turning one feature request into a clear flow: PRD, TechSpec, Tasks, implementation, verification, local commit, and branch handoff.

The npm package is only an installer for skill files. It does not run the workflow, own feature state, push branches, or open pull requests.

Why Star This Repo

• Works where you already code: Claude, Codex, and Gemini.
• Keeps the workflow simple: install once, then invoke the skill from a prompt.
• Produces plain repo artifacts your team can review and keep.
• Adds an implementation grill before coding so weak specs, missing tests, and handoff gaps are found early.
• Stops at a clean local branch handoff. You stay in control of push and PR creation.

Quick Start

Install the skill files:

npx -y @viniciuscarvalho/feature-marker install --runtime all

Open any git project in Claude, Codex, or Gemini and ask:

Use feature-marker to implement my-feature.

feature-marker will create or reuse:

tasks/my-feature/prd.md
tasks/my-feature/techspec.md
tasks/my-feature/tasks.md

Then it works through the feature, verifies it, commits locally, and prints the exact commands you can run to push and open a PR.

Install

Use npx when you want the latest npm installer without a global install.

Install only Claude:

npx -y @viniciuscarvalho/feature-marker install --runtime claude

Install the skill into all supported runtimes:

npx -y @viniciuscarvalho/feature-marker install --runtime all

Install only one runtime:

npx -y @viniciuscarvalho/feature-marker install --runtime codex
npx -y @viniciuscarvalho/feature-marker install --runtime gemini

Use --dry-run to preview install targets:

npx -y @viniciuscarvalho/feature-marker install --runtime all --dry-run

Global npm install is optional and only shortens the command:

npm install -g @viniciuscarvalho/feature-marker
feature-marker install --runtime codex

Homebrew is also supported on macOS/Linux:

brew tap viniciuscarvalho/tap
brew install feature-marker
feature-marker install --runtime all

Use In Your LLM

After installation, open any git project in Claude, Codex, or Gemini and invoke the skill from the prompt. Interactive mode is not required and is not the v1 path.

Claude prompt:

Use feature-marker to implement billing-observability.

Codex or Gemini prompt:

Use feature-marker to plan and implement billing-observability.

Use feature-marker in tasks-only mode for billing-observability.

Use feature-marker to create only the PRD for import-csv.

The skill reads the repository, creates or uses artifacts under tasks/{slug}/, runs through PRD -> TechSpec -> Tasks -> implementation grill -> implementation -> verification, commits locally, and prints exact push/PR handoff commands. The grill pass finds gaps before coding; it asks the user only when a finding changes scope or requires a product decision.

PRD, TechSpec, and Tasks are created from bundled templates installed with the skill. The agent fills {slug} and {feature_title} and writes: tasks/{slug}/prd.md, tasks/{slug}/techspec.md, and tasks/{slug}/tasks.md.

How It Works

The published package contains a small installer CLI and the skill files. The code path is intentionally narrow: