Skip to content

fix(framework): replace hardcoded npx with a <runner> placeholder in skills #1044

Open

Description

@ljulgold

Summary: Several shipped skills hardcode npx in their commands; users on alternative Node runners (pnpx, bunx, nubx, pnpm dlx, …) cannot run them.

🌟 Objective / Problem

Skills under plugins/ invoke npx directly. On machines where npx is not installed — increasingly common with alternative Node toolchains — the affected skills fail. Example: 01-acceptance-qa requires resolving npx as a prerequisite, so the whole QA flow is blocked on such machines.

Affected locations (found by grepping the shipped plugins for npx):

  • plugins/aidd-qa/skills/01-acceptance-qa/references/interface-browser-playwright-cli.md — 6 occurrences, e.g. npx --yes @playwright/[email protected] -s=qa-<run-id> <command>
  • plugins/aidd-qa/skills/01-acceptance-qa/actions/02-prerequisites.md — 2 occurrences (the check resolves npx and runs npx --yes @playwright/[email protected] --version)
  • plugins/aidd-context/skills/12-cook/assets/recipes/mcp-installation.md — 1 occurrence (npx playwright)

🛠️ Proposed Solution

  1. Replace every hardcoded npx in skill content with a <runner> placeholder, meaning "any package runner: npx, pnpx, bunx, nubx, pnpm dlx, …".
  2. State the convention once at the top of each affected file, e.g.: <runner> is your package runner: npx, pnpx, bunx, nubx, …
  3. In the 01-acceptance-qa prerequisites check, resolve whichever runner is available instead of requiring npx specifically.

🔍 Context / Technical Constraints (Optional)

  • Out of scope: historical records under aidd_docs/tasks/ and the CLI install docs (cli/README.md), where npx @ai-driven-dev/cli@latest setup is the canonical npm install path.

🙏 QA

Validation must be done with an alternative package runner (pnpx, bunx, nubx, pnpm dlx, …) — not with npm/npx.

  • No hardcoded npx remains in the shipped skills under plugins/
  • Each file that uses <runner> defines the placeholder once
  • 01-acceptance-qa prerequisites pass on a machine where npx is absent, resolving an alternative runner instead
  • The 01-acceptance-qa flow runs end to end through an alternative runner (pnpx, bunx or nubx) and produces its evidence videos
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions