Skip to content

Install the agent skill with one command: dart run skills@ get - #92

Merged
KamilSztandur merged 8 commits into
mainfrom
package-skills-cli
Sep 21, 2026
Merged

KamilSztandur merged 8 commits into
mainfrom
package-skills-cli

Conversation

@KamilSztandur

@KamilSztandur KamilSztandur commented Sep 21, 2026

Copy link
Copy Markdown
Collaborator

Problem

To use our agent skill today you have to know it exists, open the docs, copy a 800-line file into the right folder for your agent, and remember to do it again after every upgrade of the package. Most people won't.

Solution

image image

Dart now has package skills: a package ships its skills, and dart run skills@ get installs them into the project. The CLI looks at your dependencies, finds the skills they carry, puts each one where your agent reads it, and offers an update when a package changes version. Piotr suggested it in #86.

To make our skill a package skill, the folder is renamed to skills/advanced_forms-build-forms/ — the CLI wants <package>-<skill> and skips anything else.

The docs and the site now show this as the way to install it:

  • The skill page keeps the copy button at the top, for people who want to read the skill first, and then walks through the CLI step by step: add the package, run dart run skills@ get, check it loaded, ask for a form, update.
  • On the landing the skill section moves up, right under the hero, with the command ready to copy.
  • README, changelog and the docs home say the same.

Tested on example/: the CLI finds the skill, sees Claude Code, and installs it into .claude/skills/.

🤖 Generated with Claude Code

Dart's skills CLI installs the skills a project's dependencies carry
into the folder the detected agent reads, and offers updates after a
package upgrade — nobody has to know we have a skill or where their
agent keeps skills. It requires the folder to be named
<package>-<skill>, so skills/advanced_forms/ becomes
skills/advanced_forms-forms/ and `name:` follows. Verified against
example/, which depends on the package by path: the CLI detects Claude
Code, installs to .claude/skills/advanced_forms-forms/ and lists it.

The docs page leads with the CLI; copy-paste and curl stay for reading
the skill before adding the package, or for an agent the CLI does not
know. README and CHANGELOG follow.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Sep 21, 2026

Copy link
Copy Markdown

Docs preview: https://advanced-forms-k7uz2dnw1-leancode.vercel.app

Built from 8aabbd5; the landing page is at /, the docs under /docs.

KamilSztandur and others added 5 commits September 21, 2026 19:05
The band still told visitors to copy a file. Now it carries the same
copyable command box the hero has — `dart run skills@ get` — with the
box extracted into InstallCommand so the two stay one component.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
`dart run skills@ get` sat inside a tab in the first install step and
was easy to skip. Now it is the first code block on the skill page and
in the callout on the docs home. On the landing, the skill band moves
up from the bottom to right under the hero, above "The model".

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The copy-paste card stays where a visitor lands, for reading the skill
before adding the package. Under it, a banner in the accent — "Get
this skill with one command line" — opens the default path: add the
package, `dart run skills@ get`, check, ask for a form, keep it
current. Copy-paste and curl move into one closing callout.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The accent fill shouted over the copy card. Now a soft tint with an
accent rule and a smaller title, aligned with its icon.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The docs' heading rules give every h2 a top margin and padding, which
pushed the banner's title under its icon. Inline zeroes beat them.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@KamilSztandur KamilSztandur changed the title Agent skill: install it with Could not auto-detect agent and none selected. Use --agent to specify one of: antigravity, claude, cline, codex, copilot, cursor, opencode, generic Install the agent skill with one command: dart run skills@ get Sep 21, 2026
"advanced_forms-forms" stuttered. The Dart team names its skills
<prefix>-<action> (dart-add-unit-test, dart-build-cli-app); ours builds
forms. The CLI still finds it on example/.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@mateusz-pietras mateusz-pietras mentioned this pull request Sep 21, 2026
@KamilSztandur
KamilSztandur merged commit b919ff0 into main Sep 21, 2026
5 checks passed
@KamilSztandur
KamilSztandur deleted the package-skills-cli branch September 21, 2026 20:53
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