Skip to content

chore(skills): Reorganize skill directories#1597

Merged
yamadashy merged 2 commits into
mainfrom
chore/skills-reorganize
May 24, 2026
Merged

chore(skills): Reorganize skill directories#1597
yamadashy merged 2 commits into
mainfrom
chore/skills-reorganize

Conversation

@yamadashy

Copy link
Copy Markdown
Owner

Summary

Reorganizes the skill directory layout for clearer separation between externally managed skills, project-internal skills, and harness-specific entry points.

  • Move externally managed skills (agent-carnet, contextual-commit) under .agents/skills/, with .claude/skills/ symlinks kept for harness compatibility. Add contextual-commit to skills-lock.json and mark agent-carnet as internal.
  • Move the project-internal repomix-explorer skill from .claude/skills/ to a top-level skills/ directory, keeping a .claude/skills/repomix-explorer symlink so existing CLI/plugin references still resolve.
  • Update the Hermes install URL in README.md and all 15 translated repomix-explorer-skill.md guides to point at the new skills/repomix-explorer/SKILL.md path.

Checklist

  • Run `npm run test`
  • Run `npm run lint`

🤖 Generated with Claude Code

yamadashy added 2 commits May 24, 2026 19:20
decision(skills-layout): Move skills to .agents/skills with .claude/skills symlinks for harness compatibility
decision(agent-carnet): Mark as internal via metadata flag
intent(skills-layout): Separate project-internal skills from harness-specific .claude/skills/
decision(compat): Keep .claude/skills/repomix-explorer as symlink so existing CLI/plugin references still resolve
constraint(hermes-docs): Hermes install URL in README and 15 translated guides points at raw GitHub paths, so the move requires updating every docs locale
@coderabbitai

coderabbitai Bot commented May 24, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: e02a1290-b73f-4505-a13b-91820375f5ed

📥 Commits

Reviewing files that changed from the base of the PR and between b2e60fd and 6c6bb0e.

📒 Files selected for processing (22)
  • .agents/skills/agent-carnet/SKILL.md
  • .agents/skills/contextual-commit/SKILL.md
  • .claude/skills/contextual-commit
  • .claude/skills/repomix-explorer
  • README.md
  • skills-lock.json
  • skills/repomix-explorer/SKILL.md
  • website/client/src/de/guide/repomix-explorer-skill.md
  • website/client/src/en/guide/repomix-explorer-skill.md
  • website/client/src/es/guide/repomix-explorer-skill.md
  • website/client/src/fr/guide/repomix-explorer-skill.md
  • website/client/src/hi/guide/repomix-explorer-skill.md
  • website/client/src/id/guide/repomix-explorer-skill.md
  • website/client/src/it/guide/repomix-explorer-skill.md
  • website/client/src/ja/guide/repomix-explorer-skill.md
  • website/client/src/ko/guide/repomix-explorer-skill.md
  • website/client/src/pt-br/guide/repomix-explorer-skill.md
  • website/client/src/ru/guide/repomix-explorer-skill.md
  • website/client/src/tr/guide/repomix-explorer-skill.md
  • website/client/src/vi/guide/repomix-explorer-skill.md
  • website/client/src/zh-cn/guide/repomix-explorer-skill.md
  • website/client/src/zh-tw/guide/repomix-explorer-skill.md

📝 Walkthrough

Walkthrough

This PR restructures skill organization by introducing canonical skill paths, marking agent-carnet as internal, adding skill reference files, and updating Hermes Agent installation documentation across all language guides to use the new skill path structure.

Changes

Skill Structure and Path Update

Layer / File(s) Summary
Skill metadata and reference setup
.agents/skills/agent-carnet/SKILL.md, .claude/skills/contextual-commit, .claude/skills/repomix-explorer, skills-lock.json
Agent-carnet skill is marked internal, .claude/skills/ reference symlinks are created as pointers to canonical locations, and contextual-commit skill is registered in the lock file with source and computed hash.
Repomix Explorer canonical path migration
README.md, website/client/src/de/guide/repomix-explorer-skill.md, website/client/src/en/guide/repomix-explorer-skill.md, website/client/src/es/guide/repomix-explorer-skill.md, website/client/src/fr/guide/repomix-explorer-skill.md, website/client/src/hi/guide/repomix-explorer-skill.md, website/client/src/id/guide/repomix-explorer-skill.md, website/client/src/it/guide/repomix-explorer-skill.md, website/client/src/ja/guide/repomix-explorer-skill.md, website/client/src/ko/guide/repomix-explorer-skill.md, website/client/src/pt-br/guide/repomix-explorer-skill.md, website/client/src/ru/guide/repomix-explorer-skill.md, website/client/src/tr/guide/repomix-explorer-skill.md, website/client/src/vi/guide/repomix-explorer-skill.md, website/client/src/zh-cn/guide/repomix-explorer-skill.md, website/client/src/zh-tw/guide/repomix-explorer-skill.md
README and all 16 language-localized Hermes Agent installation guides are updated to reference repomix-explorer/SKILL.md from the canonical main/skills/ repository path instead of the previous .claude/skills/ directory.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

  • yamadashy/repomix#1564: Directly modifies the same agent-carnet skill document to add internal metadata.
  • yamadashy/repomix#1103: Originally introduced the repomix-explorer skill at .claude/skills/repomix-explorer/SKILL.md which is now being migrated to canonical path.
  • yamadashy/repomix#1281: Originally added the contextual-commit skill which is now being registered in .claude/skills/ and skills-lock.json.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: reorganizing skill directories for better separation of concerns across externally managed, project-internal, and harness-specific skills.
Description check ✅ Passed The description is comprehensive and well-structured. It clearly explains the reorganization objectives, specific changes made, and includes the required checklist, though checklist items remain unchecked.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/skills-reorganize

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 and usage tips.

@github-actions

github-actions Bot commented May 24, 2026

Copy link
Copy Markdown
Contributor

⚡ Performance Benchmark

Latest commit:6c6bb0e chore(skills): Move repomix-explorer to top-level skills/ directory
Status:✅ Benchmark complete!
Ubuntu:0.70s (±0.02s) → 0.70s (±0.01s) · -0.00s (-0.1%)
macOS:0.42s (±0.02s) → 0.43s (±0.08s) · +0.01s (+3.4%)
Windows:0.89s (±0.01s) → 0.89s (±0.02s) · -0.00s (-0.2%)
Details
  • Packing the repomix repository with node bin/repomix.cjs
  • Warmup: 2 runs (discarded), interleaved execution
  • Measurement: 20 runs / 30 on macOS (median ± IQR)
  • Workflow run

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the metadata for the agent-carnet skill and adds the contextual-commit skill to the skills-lock.json file. It also updates the installation URLs for the repomix-explorer skill across the README and various localized documentation files, shifting the path from .claude/skills/ to skills/. I have no feedback to provide as there are no review comments.

@codecov

codecov Bot commented May 24, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.86%. Comparing base (d4c73dc) to head (6c6bb0e).
⚠️ Report is 5 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1597   +/-   ##
=======================================
  Coverage   90.86%   90.86%           
=======================================
  Files         121      121           
  Lines        4683     4683           
  Branches     1088     1088           
=======================================
  Hits         4255     4255           
  Misses        428      428           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@yamadashy yamadashy merged commit e0924b6 into main May 24, 2026
56 checks passed
@yamadashy yamadashy deleted the chore/skills-reorganize branch May 24, 2026 12:52
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.

1 participant