Skip to content

docs: install LikeC4's skill from likec4.dev, not its GitHub mirror - #13

Merged
kieronlanning merged 2 commits into
mainfrom
docs/likec4-dsl-location
Nov 4, 2026
Merged

kieronlanning merged 2 commits into
mainfrom
docs/likec4-dsl-location

Conversation

@kieronlanning

Copy link
Copy Markdown
Contributor

I pointed at npx skills add https://github.com/likec4/likec4 --skill likec4-dsl. That works, but it is the repository copy: LikeC4 publishes the skill over the Agent Skills Discovery protocol at https://likec4.dev/, which is what its own AI Tools page documents, and the registry entry is likec4.dev@likec4-dsl (2.5K installs, against 132 for the repo listing).

Retested, not re-asserted

npx skills add https://likec4.dev/

→ finds and copies likec4-dsl with its 15 reference files (specification, model, views, deployment, diffs, dynamic-views, predicates, cli, troubleshooting, …). Its rules are the same ones quoted here: projects by nearest config file, identifiers vs FQNs (payment-api valid, payment.api not), cross-file scoping. The page also documents the MCP server (@likec4/mcp) for querying a model, which the guide now mentions.

Changed

File Now
skills/purview-astroc4-plugin/SKILL.md npx skills add https://likec4.dev/; metadata.companion-skills: likec4.dev@likec4-dsl
skills/purview-astroc4-grammar/SKILL.md Same companion value
docs/wiki/guide/Getting-Started.md The site command, the discovery protocol, links to AI Tools and the MCP server
docs/wiki/guide/README.md Site command + AI Tools link, no registry link
AGENTS.md Site command
CHANGELOG.md Corrected entry

The likec4/likec4 copy is now mentioned only as the fallback when the discovery endpoint is unreachable.

Verified

  • Both SKILL.md frontmatter blocks parse and carry companion-skills: likec4.dev@likec4-dsl
  • No likec4/likec4@likec4-dsl, github.com/likec4/likec4 --skill or skills.sh/likec4/likec4 references remain anywhere
  • 29 relative links resolve

I pointed at likec4/likec4 --skill likec4-dsl. That installs, but it is the repository copy: LikeC4 publishes the skill over the Agent Skills Discovery protocol at https://likec4.dev/, which is what its own AI Tools page documents, and the registry entry is likec4.dev@likec4-dsl (2.5K installs against 132 for the repo listing).

Retested rather than re-asserted: npx skills add https://likec4.dev/ copies likec4-dsl with its 15 reference files, and its rules are the same ones quoted here - projects by nearest config file, identifiers vs FQNs, cross-file scoping. Every pointer now names likec4.dev: both skills, the guide index, Getting Started, AGENTS and the changelog. The repo copy stays mentioned only as the fallback when the discovery endpoint is unreachable.
@kieronlanning
kieronlanning merged commit 49c1a13 into main Nov 4, 2026
4 checks passed
@kieronlanning
kieronlanning deleted the docs/likec4-dsl-location branch November 4, 2026 08:50
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