Przejdź do treści
Biblioteka skilli
AI i agenci · Budowanie i kod

skill-author

/skill-author

Decyduje, czy skill ma zakres w środowisku czy w projekcie, i zapisuje plik SKILL.md we właściwym miejscu, przy tworzeniu lub udostępnianiu.

Licencja
MIT
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Decyduje, czy skill ma zakres w środowisku czy w projekcie, i zapisuje plik SKILL.md we właściwym miejscu, przy tworzeniu lub udostępnianiu.

Oryginalny opis (EN)

Use when creating, extracting, editing, or sharing a skill — decides harness vs project scope with a judge call, then writes the SKILL.md at the right home. Trigger keywords: new skill, create a skill, write a skill, extract this into a skill, skill for, share my skills, skill scope.

Jak działa

  1. Step 1 — Scope the skill (mandatory, before writing)
  2. Step 2 — Write the description, not the body, first
  3. Step 3 — Body shape
  4. Step 4 — Verify it before shipping
  5. Step 5 — Register only what needs routing
  6. Step 6 — Log and share
  7. Anti-patterns
Sekcje z nagłówków SKILL.md, w oryginale · 70 linii, 628 słów
Podgląd SKILL.md
---
name: skill-author
description: Use when creating, extracting, editing, or sharing a skill — decides harness vs project scope with a judge call, then writes the SKILL.md at the right home. Trigger keywords: new skill, create a skill, write a skill, extract this into a skill, skill for, share my skills, skill scope.
---

# Skill author — judge scope first, then write

A skill is a routing document, not an essay. Its description decides whether it ever loads; its body decides whether loading helps. Get the scope wrong and the wrong home rots.

## Step 1 — Scope the skill (mandatory, before writing)

```bash
node ~/.config/opencode/scripts/spec-triage.mjs --scope "<what the skill does, and who it serves>"
```

| Verdict | Home |
|---|---|
| `harness` | `~/.config/opencode/skill/<name>/SKILL.md` — applies to every project |
| `project` | `<repo>/.opencode/skill/<name>/SKILL.md` — one codebase, stack, or client |

Rules:
- **Unclear means project.** Only promote to harness when the judge says harness with confidence ≥ 0.7 and you can name the cross-project concern in one sentence.
- `source: fallback` or any `override` → ask the user before installing globally.
- A project skill that earns reuse gets promoted later. A harness skill that turns out to be one repo's quirk is worse: it loads everywhere and fits nowhere.
- Check for an existing owner first: `ls ~/.config/opencode/skill` and the project's `.opencode/skill`. Extending one skill beats adding a near-duplicate that competes for the same trigger.

## Step 2 — Write the description, not the body, first

The description is the entire product: it is what the agent sees before deciding to load.

```yaml
description: Use when <situation, in the user's words>. <One sentence on what it does.> Trigger keywords: <5-8 phrases someone would actually type>. DO NOT trigger for <the nearest false positive>.
```

- Trigger phrases come from real requests, not synonyms you invented.
- Name the nearest false positive explicitly, or the skill will steal another skill's traffic.
- Harness skills are global: their description competes with ~15 others. If two descriptions overlap, one of them is redundant.

## Step 3 — Body shape

Under ~100 lines. Structure:

1. **One-line purpose**, then the rule that matters most.
2. **When this applies / when it does not** — if the description was precise, this is one line.
3. **Steps**, numbered, with the actual command or path.
4. **Hard rules** — the ones that prevent a known failure, each with its reason.
5. **Output contract** — what the caller should get back.
6. **Anti-patterns** — failures already observed, not hypotheticals.

No preamble, no motivation section, no restating the description. If a rule cannot be checked, cut it or make it checkable.

## Step 4 — Verify it before shipping

- **Trigger test:** would a fresh session load this on the intended phrase, and *not* load it on the nearest false positive? Read only the description and answer.
- **Collision test:** `grep -h "^description:" ~/.config/opencode/skill/*/SKILL.md` — if yours overlaps, sharpen or merge.
- **Path test:** every path in the body resolves from the home you chose.
- **Scope test:** does the body assume one repo? Then it is a project skill, whatever the judge said.

## Step 5 — Register only what needs routing

Add an AGENTS.md row only when the skill is a *seat*: a situation the primary must be routed to (review gate, spec authoring, design). Reference material and technique skills stay unlisted and load by description.

## Step 6 — Log and share

- Harness skill changed → one line in `~/.config/opencode/notes/harness-changelog.md` (what changed, why, how it will be measured).
- Sharing: copy the folder into the personal skills repo, keep the relative paths working, and do not strip the trigger keywords on the way out — they are the part other people need most.

## Anti-patterns

- Writing the body first and back-filling a vague description: the skill never loads.
- A harness skill whose content is one project's convention.
- Two skills with the same trigger: whichever loads is luck.
- A skill that restates doctrine already in AGENTS.md, so the two drift.

Wersje

RepozytoriumWynikLicencja
Ta strona · robruiz/rob-ruiz-skills100MIT
pinvou/pinvou-agent100MIT
SkillMedev/skills100MIT
hagaiw/skillroll90MIT

Migawka bazy z 13.11.2026 · wersja paczki df4da20b97bf (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100writing-skills
    Tworzy i sprawdza pod presją skille agenta: wyzwalacze, cienki SKILL.md, referencje i walidację, przy tworzeniu lub zmianie skilli w repozytorium.
  • 100skill-creator-plus
    Tworzy lub ocenia skill SKILL.md pakujący przepływ pracy i decyduje, czy zadanie ma być skillem, promptem, agentem czy hakiem.
  • 93create-skill
    Prowadzi przez tworzenie skilli dla agentów: strukturę, dobre praktyki i format SKILL.md.
  • 100agent-skill-author
    Prowadzi przez tworzenie i dopracowanie Agent Skill (plik SKILL.md) metodą empiryczną: sprawdza prawdziwe porażki agenta i projektuje skill pod realne luki.
  • 100create-skill
    Prowadzi przez tworzenie skilli Agent Skills dla Cursor, w tym strukturę, dobre praktyki i format SKILL.md.
  • 98create-skill
    Prowadzi przez tworzenie skilli dla Cursor: strukturę, dobre praktyki i format SKILL.md.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.