Skip to content

Commit 65001ad

Browse files
roxblnfkroxblnfk
committed
Update skills.md with improved quick start instructions and plugin usage details
1 parent e0c19d4 commit 65001ad

2 files changed

Lines changed: 52 additions & 63 deletions

File tree

‎blog/skills.md‎

Lines changed: 26 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -74,58 +74,52 @@ The package is 95% vibe-coded, but that's nothing to worry about: it's all cover
7474

7575
## Quick start
7676

77-
1. Install `llm/skills` (and bring Testo up to date while you're at it):
78-
79-
```bash
80-
composer require --dev llm/skills
81-
```
82-
83-
2. Tweak `composer.json` if you want a different target folder (default is `.agents/skills`) or want to extend the trusted-vendor list:
77+
1. Add the settings to `composer.json`:
8478

8579
```json
8680
{
8781
"extra": {
8882
"skills": {
89-
"target": ".claude/skills",
90-
"trusted": ["my-vendor/*"]
83+
"target": ".agents/skills",
84+
"aliases": [".claude/skills", ".cursor/skills"],
85+
"trusted": ["my-vendor/*"],
86+
"discovery": true,
87+
"auto-sync": true
9188
}
9289
}
9390
}
9491
```
9592

96-
3. See what skills are available:
93+
- `target` — the real skills directory (default `.agents/skills`).
94+
- `aliases` — extra mirror paths (Windows junctions or POSIX symlinks) pointing at `target`. Handy when a project hosts several agents at once: Claude Code, Cursor & friends read the same skills through their own conventional paths, no duplicated files.
95+
- `trusted` — trusted-vendor patterns (`vendor/*` or `vendor/package`). Testo and a few others are already in the built-in whitelist, so this is usually where you list your own additions.
96+
- `discovery` — pick up skills from packages that don't declare `extra.skills` but ship a `skills/` folder at the root. `false` by default.
97+
- `auto-sync` — run `skills:update` automatically after `composer install` / `update`.
9798

98-
```bash
99-
composer skills:show --discover
100-
```
101-
102-
4. Pull skills into the project.
103-
104-
Everything from trusted vendors:
99+
2. Install the plugin — it'll pick up the skills and lay them out right away:
105100

106101
```bash
107-
composer skills:update --discover
102+
composer require --dev llm/skills
108103
```
109104

110-
Or specific vendors:
105+
Composer will ask for permission to run the plugin (`allow-plugins`) — say yes.
111106

112-
```bash
113-
composer skills:update testo/*
114-
```
107+
3. See what else is available to sync.
115108

116-
5. Wire up auto-update in `composer.json`:
109+
`composer skills:show` is a read-only inspector that tells you what's syncing, what's skipped, and why. Useful flags:
117110

118-
```json
119-
{
120-
"scripts": {
121-
"post-install-cmd": ["@composer skills:update"],
122-
"post-update-cmd": ["@composer skills:update"]
123-
}
124-
}
111+
```bash
112+
composer skills:show # current layout
113+
composer skills:show --discovery # + packages with a skills/ folder but no extra.skills
114+
composer skills:show --trust='acme/*' # + what would unlock if you extended trust
125115
```
126116

127-
That's it — the Testo skills are now sitting in `.claude/skills/`, and Claude Code will pick them up on its next run. Using a different agent? Just point `target` at whatever path it reads from.
117+
Spot a `[skip] not trusted` next to something interesting? Add the vendor to `trusted` and the skills will land on the next sync. For a one-off sync, name the package right in the command: `skills:update acme/foo`.
128118

129119
::: tip
130-
`composer skills:show` previews what's about to land where, without touching the disk. Handy to run before your first `update`.
120+
You can install the plugin globally — then `composer skills:show` / `skills:update` work in any project, while the per-project settings (`target`, `aliases`, `trusted`) are still read from the local `composer.json`:
121+
122+
```bash
123+
composer global require llm/skills
124+
```
131125
:::

‎ru/blog/skills.md‎

Lines changed: 26 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -74,57 +74,52 @@ faqLevel: false
7474

7575
## Быстрый старт
7676

77-
78-
1. Поставить пакет `llm/skills` и обновить Testo.
79-
80-
```bash
81-
composer require --dev llm/skills
82-
```
83-
84-
2. Настроить `composer.json`, если надо складывать скиллы в другую папку (по умолчанию `.agents/skills`) или расширить список доверенных вендоров:
77+
1. Прописать настройки в `composer.json`:
8578

8679
```json
8780
{
8881
"extra": {
8982
"skills": {
90-
"target": ".claude/skills",
91-
"trusted": ["my-vendor/*"]
83+
"target": ".agents/skills",
84+
"aliases": [".claude/skills", ".cursor/skills"],
85+
"trusted": ["my-vendor/*"],
86+
"discovery": true,
87+
"auto-sync": true
9288
}
9389
}
9490
}
9591
```
9692

97-
3. Чтобы посмотреть, какие скиллы доступны:
93+
- `target` — реальная папка со скиллами (дефолт `.agents/skills`).
94+
- `aliases` — дополнительные пути-зеркала (junction на Windows, symlink на POSIX), указывающие на `target`. Удобно, когда в проекте живут несколько агентов: Claude Code, Cursor и компания читают один и тот же набор через свои привычные пути, без дублирования файлов.
95+
- `trusted` — доверенные вендоры в формате `vendor/*` или `vendor/package`. Testo и часть других пакетов уже сидят во встроенном whitelist'е, так что сюда обычно добавляют что-то своё.
96+
- `discovery` — подбирать скиллы из пакетов, у которых нет `extra.skills`, но есть папка `skills/` в корне. По умолчанию `false`.
97+
- `auto-sync` — гонять `skills:update` автоматически после `composer install` / `update`.
9898

99-
```bash
100-
composer skills:show --discover
101-
```
102-
4. Скачать скиллы в проект:
99+
2. Поставить плагин — он сразу же подхватит и разложит скиллы по указанным путям:
103100

104-
Всё из списка доверенных вендоров:
105101
```bash
106-
composer skills:update --discover
102+
composer require --dev llm/skills
107103
```
108104

109-
Конкретные вендоры:
105+
Composer спросит разрешение запустить плагин (`allow-plugins`) — соглашайтесь.
110106

111-
```bash
112-
composer skills:update testo/*
113-
```
107+
3. Посмотреть, что ещё можно синкнуть.
114108

115-
5. Донастроить `composer.json` на автообновление.
109+
`composer skills:show` — read-only инспектор: показывает, что уже синкается, что пропущено и почему. Полезные флаги:
116110

117-
```json
118-
{
119-
"scripts": {
120-
"post-install-cmd": ["@composer skills:update"],
121-
"post-update-cmd": ["@composer skills:update"]
122-
}
123-
}
111+
```bash
112+
composer skills:show # текущая раскладка
113+
composer skills:show --discovery # + пакеты с папкой skills/ без extra.skills
114+
composer skills:show --trust='acme/*' # + что окажется доступным, если расширить трасты
124115
```
125116

126-
Всё — скиллы Testo лежат в `.claude/skills/`, и Claude Code подхватит их при следующем запуске. Используете другого агента — поменяйте `target` на нужный путь.
117+
Заметили `[skip] not trusted` напротив интересного пакета — добавьте его в `trusted`, и при следующем синке скиллы приедут. Для однократного синка можно указать пакет прямо в команде `skills:update acme/foo`
127118

128119
::: tip
129-
`composer skills:show` покажет, что куда поедет, без записи на диск. Удобно проверить перед первым `update`.
120+
Плагин можно поставить глобально — тогда `composer skills:show` / `skills:update` будут доступны в любом проекте, а настройки (`target`, `aliases`, `trusted`) всё равно читаются из локального `composer.json`:
121+
122+
```bash
123+
composer global require llm/skills
124+
```
130125
:::

0 commit comments

Comments
 (0)