Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

stacks-author

/stacks-author

Tworzy, konwertuje lub zgłasza wpis stacks: fragment, szablon projektu lub kartę wyszukiwania do rejestru.

Repozytorium
stacks ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
08.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
7
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Tworzy, konwertuje lub zgłasza wpis stacks: fragment, szablon projektu lub kartę wyszukiwania do rejestru.

Oryginalny opis (EN)

Create, convert or submit a stacks entry. Use when the user wants to make a stack or fragment, turn an existing repo into a stack, write a reusable project template or recipe for coding agents, add a capability (CI, auth, a database, an app) as a fragment, write a search card, or submit an entry to the public stacks registry.

Jak działa

  1. Anatomy
  2. Workflow
  3. Hard rules
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 724 słów
Podgląd SKILL.md
---
name: stacks-author
description: Create, convert or submit a stacks entry. Use when the user wants to make a stack or fragment, turn an existing repo into a stack, write a reusable project template or recipe for coding agents, add a capability (CI, auth, a database, an app) as a fragment, write a search card, or submit an entry to the public stacks registry.
---

# stacks-author

A stack is a recipe for a new project: dependencies by role, starter files, agent guidance and verify steps that define done. A fragment adds one capability to a stack. You write the entry; an agent later builds a project from its brief with current versions.

Use `stacks` on PATH, otherwise `npx -y @steamfield/stacks@latest`; `<cli>` means that command. If a command or flag named here is missing, run `<cli> --version`, tell the user this skill needs a newer stacks, and ask them to run `<cli> update`.

## Anatomy

```text
<id>/
  STACK.md            frontmatter + guidance (FRAGMENT.md for a fragment)
  files/              the working slice: source, tests, configs, docs; *.tmpl takes {{project_name}} and a few other variables
  adapters/claude/    files only Claude Code targets get (also codex/, opencode/, cursor/)
search/stacks/<id>.json   the search card, beside the entry directories
```

- **Frontmatter**: `id`, `name`, `description`, `tags` (exactly one of `make` or `scripts`), `deps` as package names by role (never versions), `tools`, `commands` (every command verify uses), `verify` steps with a `layer` (install, lint, typecheck, test, and a `serve` probe for `web` or `api`), `decisions` each with `(default: ...)`, and `fragments` (required, default, optional).
- **Body**: what stacks wrote, Layout, numbered Setup, Conventions, Testing, Commands, Gotchas. It points at the shipped code instead of restating it.
- **Fragment**: adds `category`, `applies_to`, `requires`, `conflicts`, `requires_tools`, and a body that says what to add plus the `AGENTS.md` section the project gets. An app is a fragment with `category: app`.

**Ship working code, never versions.** `files/` holds a small working slice (source, tests, configs, docs) that passes every verify step once dependencies are installed. No versions, ranges, `engines`, toolchain directives or action refs; the building agent installs current releases and updates what they outdate. Ship only what a verify step exercises.

Full format: `references/anatomy.md`.

## Workflow

1. **Search first.** Run `<cli> search "<what the user wants>" --json` and read the closest hits with `<cli> show <id> --json`. If an existing stack plus fragments covers the need, recommend that and stop unless the user still wants a new entry.
2. **Stack or fragment.** Something that differs from an existing stack only in CI, deployment or one tool is a fragment. See `references/fragment.md`.
3. **Pick the route.** Converting a repo the user has: `references/from-repo.md`. Designing from scratch: `references/interview.md`. Both end with a summary the user approves before you write anything.
4. **Create the skeleton.** `<cli> create stack <id> --json` or `<cli> create fragment <id> --category <category> --json`. The result's `path` is the entry directory in the user registry. Choose the id with care: see the hard rules.
5. **Fill it in** per `references/anatomy.md`. Replace every `stacks:fill` marker. Write the search card per `references/search-card.md`.
6. **Validate.** Run `<cli> validate <path> --json` and fix every error at its source, and every warning except the ones maintainers clear (listed in `references/submit.md`). Preview the brief with `<cli> validate <registry-root> --brief <stack> --sandbox`.
7. **Prove it.** `<cli> new <id> <empty-tmp-dir> --sandbox --json`, then build the project yourself from `.stacks/BRIEF.md` and run `<cli> verify` until the outcome is `green`. Fix the entry wherever the brief misled you (see `.stacks/NOTES.md`), then prove it again in a fresh directory.
8. **Submit, if the user wants it public.** `references/submit.md`. Run `<cli> validate <path> --submission` and `<cli> submit <path> --dry-run` first, and get the user's yes before the real `submit`.

## Hard rules

- **No versions.** Not in `deps`, not in shipped config, not in prose outside fenced examples. Tell the building agent how to find the current version instead.
- **Ids are permanent** once published. A rename breaks stats, search judgments and older projects. Settle it with the user before `create`.
- **Never weaken verify.** When the proof run fails, fix the entry's guidance or files, not the step. Each step must prove a deliverable: a serve probe for anything that serves, a smoke run for a CLI, a build for anything that ships an artifact.
- **The CLI runs nothing from an entry.** Ship no generator, install script or hook that you expect `new` or `add` to execute. The building agent runs tools; the brief tells it how.
- **Nothing private ships.** No secrets, `.env` files, absolute paths, usernames or product names. Use `{{project_name}}` and the other template variables.
- **Claims match files.** Every claim in `description`, `deps`, decisions, body and card must hold for what `files/`, `adapters/` and `verify` actually ship.
Pliki w paczce (7)
  • SKILL.md 5 KB
  • references/anatomy.md 12 KB
  • references/fragment.md 6 KB
  • references/from-repo.md 6 KB
  • references/interview.md 3 KB
  • references/search-card.md 7 KB
  • references/submit.md 6 KB

Wersje

W bazie nie ma innych skilli o nazwie stacks-author.

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

  • 100fragment-authoring
    Tworzy i poprawia fragmenty rejestru stacków: nazwę, opis, zakres i kartę wyszukiwania, tak by pasowały do właściwych zadań.
  • 100stack-authoring
    Tworzy lub poprawia przepis stosu i kartę wyszukiwania, tak by nazwa i opis były jasne i dobrze znajdowane.
  • 96pr-stacks
    Zgłasza i śledzi zależne, nakładane na siebie pull requesty.
  • 96pr-stacks
    Wysyła i śledzi zależne, ułożone w stos pull requesty.
  • 100creating-changelog-entries
    Dodaje wpis do changelogu przez fragment Towncrier po poprawce błędu lub zmianie widocznej dla użytkownika, przed commitem lub PR.
  • 100agents-md-entry
    Ocenia AGENTS.md projektu open source i tworzy wpis korpusu do katalogu /agents-md, przy dodawaniu projektu, odświeżaniu wpisu lub partii kandydatów.

Uwagi i zgłoszenia

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