Skip to content

refactor/subfolder-skill-layout - #13

Merged
armandocodecr merged 3 commits into
mainfrom
refactor/subfolder-skill-layout
Sep 12, 2026
Merged

armandocodecr merged 3 commits into
mainfrom
refactor/subfolder-skill-layout

Conversation

@armandocodecr

Copy link
Copy Markdown
Contributor

Problem

Installing the skill in a project (npx skills add trustless-work/trustlesswork-skill) copied repo infrastructure into the consumer project: .github/, .gitignore, scripts/, LICENSE and README.md all landed inside .claude/skills/trustless-work-dev/.

The cause is in the skills.sh CLI: it copies the whole folder that contains SKILL.md, and its exclusion list is hardcoded to .git, __pycache__, __pypackages__ and metadata.json only — there is no ignore-file or frontmatter mechanism. With SKILL.md at the repo root, the repo root is the skill.

Fix

Move the installable content into trustless-work-dev/ (named after the skill's frontmatter name):

trustlesswork-skill/
├── README.md · LICENSE · .gitignore · .github/ · scripts/   ← repo infra, not installed
└── trustless-work-dev/
    ├── SKILL.md
    ├── constitution.md
    └── skills/...

The CLI discovers skills in subdirectories when there is no root SKILL.md, so the install command stays the same.

  • All internal links move together and keep resolving (verified: 0 broken relative links).
  • scripts/check-consistency.sh and the CI workflow use git ls-files, so they needed no changes and still pass.
  • README links now carry the trustless-work-dev/ prefix and the structure tree reflects the current layout (protocol/, api/v2/, react-sdk/v2/, js-sdk/).

Verified

Reproduced the dirty install from the old layout, then installed from this branch with npx skills add <path> --copy: only SKILL.md, constitution.md and skills/ are copied.

🤖 Generated with Claude Code

npx skills copies the entire folder containing SKILL.md and only
excludes .git, __pycache__ and metadata.json. With SKILL.md at the
repo root, every install dragged .github/, .gitignore, scripts/,
LICENSE and README.md into the consumer project.

Skill content (SKILL.md, constitution.md, skills/) now lives in
trustless-work-dev/, matching the frontmatter name; repo
infrastructure stays at the root and is no longer installed.
check-consistency.sh and CI are path-agnostic and unchanged;
README links updated and all relative links verified.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Sep 12, 2026 •

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 9224ee7c-3680-4bf4-ab48-cfa798e146a3


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

armandocodecr and others added 2 commits September 11, 2026 20:28
Installed copies now carry the Apache-2.0 text alongside the
frontmatter license declaration.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@JoelVR17 JoelVR17 changed the title Move skill content into a subfolder so installs stop copying repo infrastructure refactor/subfolder-skill-layout Sep 12, 2026
@armandocodecr
armandocodecr merged commit 634f32b into main Sep 12, 2026
3 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants