Skip to content

npx skills add currently installs only SKILL.md, omitting prompts/ #3

Description

@ikazoy

Hi, first of all thank you for publishing html-anything. The style/source prompt system looks really useful, and I was excited to try it from the documented npx skills add clockless-org/html-anything path.

I ran into an install issue that may affect other users following the README.

What happened

Using the documented command through skills CLI installs only the root SKILL.md; the supporting prompts/ directory is not installed.

That leaves agents with instructions that reference files such as:

  • prompts/styles/_design.md
  • prompts/styles/catalog.json
  • prompts/styles/<style>.md
  • prompts/sources/<source>.md
  • prompts/styles/references/...

but those files are missing locally. In my case the agent correctly degraded with a message like: the installed html-anything only has the explanation file, so it will apply only the general style requirements.

Reproduction

npx -y skills@latest add clockless-org/html-anything -g -a codex -s html-anything -y --copy
find ~/.agents/skills/html-anything -maxdepth 3 -type f

Actual result:

~/.agents/skills/html-anything/SKILL.md

Expected result:

~/.agents/skills/html-anything/SKILL.md
~/.agents/skills/html-anything/prompts/...

The local lock also records:

"skillPath": "SKILL.md"

Likely root cause

This appears to be a skills CLI bug rather than a problem with html-anything itself. The repo .clawhubignore clearly intends to publish both SKILL.md and prompts/**.

There is already an upstream issue and fix PR in vercel-labs/skills:

The root cause described there matches this case: when a repo has SKILL.md at the repository root, skills add treats it as a single-file root skill and drops supporting files.

Current workaround

Until the upstream CLI fix is released, cloning the repo directly preserves the referenced prompt files:

rm -rf ~/.agents/skills/html-anything
git clone https://github.com/clockless-org/html-anything ~/.agents/skills/html-anything

For Codex-specific installs:

rm -rf ~/.codex/skills/html-anything
git clone https://github.com/clockless-org/html-anything ~/.codex/skills/html-anything

Suggestion

It may be worth adding a temporary note to the README install section until skills CLI includes the upstream fix, so new users do not accidentally get the degraded SKILL.md-only install.

Thanks again for the work on this. The skill looks great; I only noticed this because the prompt/style catalog is exactly the part I wanted to try.

Update: verified the upstream PR fixes this for html-anything

I built the CLI from vercel-labs/skills PR #1609 locally and retried the same install flow against clockless-org/html-anything.

The patched CLI successfully installed the supporting prompt files. In my test install, ~/.agents/skills/html-anything/prompts contained 102 files, including:

  • prompts/styles/catalog.json
  • prompts/styles/_design.md
  • prompts/styles/teaching.md
  • prompts/sources/default.md

So this does look fixed by the upstream CLI change. Waiting for a skills CLI release that includes vercel-labs/skills#1609 is probably the cleanest path; after that, the documented npx skills add clockless-org/html-anything install should work as intended.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions