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

agent-type-advisor

/agent-type-advisor

Doradza, czy możliwość pluginu powinna być jednostką markdown interpretowaną przez LLM, czy deterministycznym skryptem, dla nowych i istniejących agentów lub skilli.

Licencja
MIT
Ostatnia zmiana repozytorium
14.10.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 14.10.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

Doradza, czy możliwość pluginu powinna być jednostką markdown interpretowaną przez LLM, czy deterministycznym skryptem, dla nowych i istniejących agentów lub skilli.

Wyzwalacze z opisu

should this be markdown or a script?

Argumenty

/agent-type-advisor <prose use-case | path/to/agent-or-skill.md>
Oryginalny opis (EN)

Recommend whether a plugin capability should be a markdown (LLM-interpreted) unit or a deterministic script. Use when designing a new agent/skill ("should this be markdown or a script?"), or when auditing an existing agent/skill file for a type mismatch. Accepts either a prose use-case description (forward- looking, new unit) or a path to an existing agent/skill file (retrospective).

Jak działa

  1. Constraints
  2. Step 1 — Read the rules
  3. Step 2 — Detect input mode
  4. Step 3a — Forward-looking (prose use-case)
  5. Step 3b — Retrospective (existing file)
  6. Step 4 — Output
Sekcje z nagłówków SKILL.md, w oryginale · 84 linii, 530 słów
Podgląd SKILL.md
---
name: agent-type-advisor
description: >-
  Recommend whether a plugin capability should be a markdown (LLM-interpreted)
  unit or a deterministic script. Use when designing a new agent/skill ("should
  this be markdown or a script?"), or when auditing an existing agent/skill file
  for a type mismatch. Accepts either a prose use-case description (forward-
  looking, new unit) or a path to an existing agent/skill file (retrospective).
argument-hint: "<prose use-case | path/to/agent-or-skill.md>"
role: worker
user-invocable: true
allowed-tools: Read, Grep, Glob
---

# Agent Type Advisor

Role: worker. Recommend **markdown** vs **script** for a plugin capability, citing
the shared decision rules so the recommendation is auditable, not a vibe.

## Constraints

1. **Cite, do not paraphrase.** Every recommendation names at least two rule IDs
   (`R1`–`R10`) from `knowledge/agent-type-decision-rules.md`. That file is the
   single source of truth — read it first, do not restate its reasoning from
   memory.
2. **Classify the input mode first.** Prose → forward-looking. File path →
   retrospective. Both modes are first-class.
3. **Behavior decides type, not extension.** Judge an existing file by what its
   body actually does, never by its `.md`/`.sh` suffix alone.
4. **Be concise.** Emit only the recommendation block. No preamble.

## Step 1 — Read the rules

Read `knowledge/agent-type-decision-rules.md` in full. It is short and is the
rule source (R1–R10, the markdown/script columns, and the confidence ladder).

## Step 2 — Detect input mode

Inspect `$ARGUMENTS`:

- If it resolves to an existing file (ends in `.md`/`.sh`/`.py` and exists on
  disk, or Glob finds it) → **retrospective mode** (Step 3b).
- Otherwise treat the whole argument as a **prose use-case** → **forward-looking
  mode** (Step 3a).

If `$ARGUMENTS` is empty, ask the user for a prose use-case or a file path and
stop.

## Step 3a — Forward-looking (prose use-case)

1. Extract the unit's *job*: what does it produce, how often does it run, does it
   gate anything, does the answer vary with phrasing/context?
2. Walk the rules. Collect every rule that applies and the column it points to.
3. Decide `markdown` or `script` by the dominant column.
4. Set confidence per the file's ladder (high / medium / low).

Output the recommendation block (Step 4) with `recommendation:` = `markdown` or
`script`.

## Step 3b — Retrospective (existing file)

1. Read the target file. Determine its *observable behavior* from the body —
   what it actually computes or produces — independent of its extension.
2. Determine the type it *should* be by the same rule walk as Step 3a.
3. Compare to the type it *currently is* (markdown unit = `.md` agent/`SKILL.md`;
   script = `.sh`/`.py`):
   - should-be matches current → `recommendation: KEEP`
   - should-be differs from current → `recommendation: CHANGE` (name the target
     type and what to extract/convert)
   - mixed mechanical + judgment → apply **R10**: if the markdown unit already
     delegates the mechanical half to a script it calls, `KEEP`; if it inlines
     mechanical enumeration, `CHANGE` (extract the script).
4. Set confidence per the ladder.

## Step 4 — Output

Emit exactly this block (Markdown), nothing else:

```text
## Agent Type Recommendation

- Target: <prose summary | file path>
- Mode: <forward-looking | retrospective>
- Recommendation: <markdown | script | KEEP | CHANGE>
  [retrospective only] Current type: <markdown | script> → Should be: <markdown | script>
- Confidence: <high | medium | low>
- Rationale: <2–3 sentences keyed to the job>
- Rules cited:
  - <Rn>: <one-line why this rule applies here>
  - <Rm>: <one-line why this rule applies here>
[low/medium confidence only]
- To raise confidence: <the missing detail>
```

At least two distinct rule IDs are required. For a `CHANGE`, cite the rule(s)
that the current type violates *and* the rule(s) that justify the target type.

Wersje

W bazie nie ma innych skilli o nazwie agent-type-advisor.

Migawka bazy z 13.11.2026 · wersja paczki 6757dc627471 (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

  • 90moo-authoring
    Pomaga dodawać lub zmieniać skill, hook albo plik runtime w repozytorium oraz zdecydować, jaką jednostką ma być nowa zdolność.
  • 100writing-skills
    Przegląda pliki skilli pod kątem jakości prozy, formatowania markdown i konwencji stylu, bez tworzenia nowych skilli.
  • 100skills-creator
    Szkicuje nowe skille, agenty, komendy i pluginy, a także doradza, czy zadanie lepiej obsłuży skill, czy agent.
  • 100create-skill
    Prowadzi przez tworzenie przenośnych skilli agentów AI w standardzie Agent Skills: szkielet katalogów lub konwersja istniejących przewodników.
  • 100plugin-audit
    Sprawdza strukturalną zgodność dowolnej wtyczki Claude Code: dobór typu agenta, frontmatter, pokrycie eval i limity długości treści, po dodaniu lub zmianie agenta albo skilla.
  • 90agent-cluster-advisor
    Doradza w architekturze systemów wieloagentowych: doborze topologii, stanu, kosztów i integracji, przed ich budową.

Uwagi i zgłoszenia

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