Skip to content

skills: rename heylogs skill to changelog and categorize skills - #570

Open
koppor wants to merge 2 commits into
nbbrd:developfrom
koppor:refine-skills
Open

skills: rename heylogs skill to changelog and categorize skills#570
koppor wants to merge 2 commits into
nbbrd:developfrom
koppor:refine-skills

Conversation

@koppor

@koppor koppor commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

My first skill with npx skills, therefore learning. Trying to code and fix fast :)

Current state:

grafik

With this update, only one changelog skill - no internal repo code skill any more.

Follow-up to #565

Rename the public `heylogs` skill to `changelog` so it no longer
collides with the project/CLI name in skill pickers, and front-load
action verbs in descriptions to avoid awkward truncation. Remove the
internal `create-rule` and `create-versioning` skills, which are not
used by maintainers and should not be public. Simplify the install
command to `npx skills add nbbrd/heylogs` since the repo now ships a
single skill.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@koppor koppor changed the title docs: rename heylogs skill to changelog and drop create-* skills skills: rename heylogs skill to changelog and drop create-* skills Jun 23, 2026
@charphi

charphi commented Jun 29, 2026

Copy link
Copy Markdown
Member

create-rule and create-versioning are development tools while heylogs is a usage tool.
There are in different folders which for me stands for different scopes.
Maybe npx has some kind of scope/category to the make the distinction?

Move the changelog skill under skills/usage/ and restore create-rule and
create-versioning under skills/contributing/ using the catalog layout
(skills/<category>/<name>/SKILL.md) supported by npx skills.

Add metadata.category to all skills and prefix the contributing-skill
descriptions so the grouping is visible to consumers. Fix the relative
links broken by the deeper nesting (README, AGENTS, in-skill ../../../).

The npx skills install command (npx skills add nbbrd/heylogs) is unchanged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@koppor koppor changed the title skills: rename heylogs skill to changelog and drop create-* skills skills: rename heylogs skill to changelog and categorize skills Jun 30, 2026
@koppor

koppor commented Jun 30, 2026

Copy link
Copy Markdown
Contributor Author

Oh, they really offer category. "I" updated.

@charphi

charphi commented Jul 15, 2026

Copy link
Copy Markdown
Member

I haven't found any documentation of the category feature of npx skills command.
Are you sure this is a real feature and not an hallucinated one?

Also, the skills folder is not referenced as a possible skill folder in GitHub Copilot settings. Therefore, it may not be found by an agent. When I asked GitHub Copilot What local skills do you have access to for this project?, it did find the skills, but I'm not sure if this is consistent and/or reliable, since I explicitly asked for it.

I'm quite confused about all this stuff 😕

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