docs: add agent-generic SKILLS.md

[koppor]

Thought, It would be nice to teach Claude (and/or other AI agents) how to check (and fix) CHANGELOG.md files. Here a (Claude-generated) proposal for SKILL.md

---

What

Adds SKILLS.md, an agent-generic guide (works with any AI coding assistant) for using the Heylogs CLI on a changelog.

Coverage, weighted toward check and rules as the primary task:

• check — invocation, output formats, options.
• Rule configuration — --rule <id>:<severity> (incl. OFF) and the persistent heylogs.properties equivalent, with hierarchical auto-discovery, override/stopBubbling/--no-config semantics.
• Config-only pattern — getting one or more repos to "0 problems" purely via heylogs.properties, without editing changelog content.
• All built-in rules — table of every rule with its default severity and a one-line description.
• Other commands — init, push, fetch, note, format, release, yank, scan, extract, export, import, list.
• Running the CLI — gg.cmd (no prerequisites) and JBang, e.g. jbang com.github.nbbrd.heylogs:heylogs-cli:0.18.1:bin check CHANGELOG.md.

Also links to SKILLS.md from AGENTS.md and README.md so agents and users can discover it (SKILLS.md is not an auto-discovered filename on its own).

The content is derived from the existing docs/ (feature-rules, feature-check, feature-config-file, usage-cli, per-command docs) and the heylogs.properties template.

🤖 Generated with Claude Code

[charphi]

@koppor thanks for the suggestion; this is a great idea.

But before merging, I'm wandering if the file SKILLS.md at the root of the project is the right place to put it.
It seems to me that it should follow the skills.sh convention to use specific folders and structure (i.e. skills/my-skill-command) ?
Here is an example of it: https://github.com/ondata/opensdmx/blob/main/docs/skill/README.md

[koppor]

I have very little experience, but npx skills seems to be nice - and one is then listed in the skills.sh page - currently many tools for changelog: https://www.skills.sh/?q=changelog

npx skills add nbbrd/heylogs --skill heylogs

Seems OK - maybe the --skill heylogs can be ommited?

[charphi]

Thanks for the contribution!

Seems OK - maybe the --skill heylogs can be ommited?

I don't know; I don't have any experience with npx.

[koppor]

Current state: