npx aidd@latest installs incomplete framework content

[ianwhitedeveloper]

Summary

npx aidd@latest does not install the full set of skills, commands, rules, and related framework content. A local install from a cloned repo restores the missing assets.

Reproduction

1. In a project, install via npx:

   npx aidd@latest --force

2. Observe that some skills, commands, rules, etc. are missing (e.g. aidd-rtc, /aidd-rtc, and related ai/skills / ai/commands entries).
3. Clone the aidd repo locally:

   git clone https://github.com/paralleldrive/aidd.git

4. Link or run the local CLI into the project, for example:

   cd aidd && npm link
   cd /path/to/project && npx aidd --force

   Or invoke the CLI directly from the clone path.
5. Observe that all skills, commands, rules, etc. are installed as expected.

Expected

npx aidd@latest --force should install the same complete framework content as running the CLI from a current local clone.

Actual

Published npx install omits multiple framework assets that appear in the repository.

Environment

• Install command: npx aidd@latest --force
• Workaround: local clone + npm link or npx <path-to-local-aidd-cli>
• Example missing content: aidd-rtc skill and /aidd-rtc command

[ianwhitedeveloper]

Validation: confirmed — root cause is a stale release, not a packaging bug

I reproduced this end-to-end. The symptom is real, but the cause is simpler than a broken package: main is ahead of the last published release.

Expected vs. actual content

Source	Skills	aidd-rtc?
Local clone (main)	35	✅ present
npx aidd@latest (3.1.0)	28	❌ missing

Content on main but missing from npx aidd@latest:

• Skills: aidd-parallel, aidd-pipeline, aidd-pr, aidd-requirements, aidd-riteway-ai, aidd-rtc, aidd-upskill, aidd-write
• Commands: aidd-parallel.md, aidd-pipeline.md, aidd-pr.md, aidd-requirements.md, aidd-riteway-ai.md, aidd-rtc.md, aidd-upskill.md
• Also: published 3.1.0 still ships aidd-functional-requirements, which was renamed to aidd-requirements on main.

Verification and root cause details

Root cause

The packaging is correct:

• package.json files includes ai/**/* — all skills/commands are eligible for publishing.
• The CLI (lib/cli-core.js) copies the entire ai/ folder from the package root, with no per-skill filtering.

The issue is the release is stale. The latest dist-tag is 3.1.0, published 2026-03-30. main is 55 commits ahead (33 touch ai/). Every missing asset was merged after 3.1.0 — e.g. aidd-rtc landed 2026-04-11 (#193), which is not an ancestor of the v3.1.0 release commit. The package isn't dropping files; no release has been cut since these skills were merged.

Reproduction (clean room)

• No npm link/global symlink to local aidd (npm ls -g --link and npm root -g both clean); npm cache only holds the real registry tarballs.
• Downloaded the actual published 3.1.0 tarball → 28 skill dirs, no aidd-rtc.
• Ran npx aidd@latest --force in a clean temp dir → installed 28 skills; aidd-rtc, aidd-write, aidd-pr, etc. all missing — matching the examples in this issue.

Recommendation

This is a process fix, not a code fix: cut a new release (npm run release) and the published package will include all current content. Given 55 unreleased commits have accumulated, it's also worth confirming the release automation is firing as expected.

[ianwhitedeveloper]

After checking with the team - I learned this is intentional for now. Closing issue accordingly.