Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Pisanie

simplify-spec

/simplify-spec

Upraszcza specyfikację projektu, usuwając szczegóły implementacji, tak by opisywała zachowanie widoczne dla użytkownika.

Repozytorium
agenttools ↗
Licencja
MIT
Ostatnia zmiana repozytorium
23.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 23.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

Upraszcza specyfikację projektu, usuwając szczegóły implementacji, tak by opisywała zachowanie widoczne dla użytkownika.

Wyzwalacze z opisu

simplify a specclean up a specremove implementation details from a specmake a spec more high-levelsimplify the spec for [feature]rewrite spec to be user-facing

Argumenty

/simplify-spec spec filename or feature name
Oryginalny opis (EN)

Simplify a design specification in Specs/ to focus on user-facing behavior. Use when asked to: "simplify a spec", "clean up a spec", "remove implementation details from a spec", "make a spec more high-level", "simplify the spec for [feature]", "rewrite spec to be user-facing", or any request to reduce internal/low-level detail in a specification document.

Jak działa

  1. Process
Sekcje z nagłówków SKILL.md, w oryginale · 61 linii, 514 słów
Podgląd SKILL.md
---
name: simplify-spec
description: |
  Simplify a design specification in Specs/ to focus on user-facing behavior.
  Use when asked to: "simplify a spec", "clean up a spec", "remove implementation details from a spec",
  "make a spec more high-level", "simplify the spec for [feature]", "rewrite spec to be user-facing",
  or any request to reduce internal/low-level detail in a specification document.
disable-model-invocation: true
argument-hint: "spec filename or feature name"
---

# Simplify a Design Specification

Rewrite a design specification to focus on user-facing behavior, removing or condensing internal implementation details. The goal is a spec that clearly communicates what the feature does and how users interact with it, without prescribing how it's built internally.

**Spec to simplify:** $ARGUMENTS

If no specific spec is given, ask the user which spec in `Specs/` they'd like simplified.

## Process

### 1. Read the Spec

Read the full spec file from `Specs/`. Identify every section and classify it:

- **User-facing:** Things a user of the paclet would see or interact with (function signatures, options, usage examples, option tables with types/defaults/descriptions, backward compatibility notes, future plans)
- **Internal:** Things only a developer implementing the feature would need (file modification lists, internal function signatures, internal symbol declarations, serialization details, parsing logic, private API code, environment variable plumbing, verification/test checklists)

### 2. Understand the Feature

Before rewriting, read the relevant source files to understand what the feature actually does. This is important because the spec may describe planned behavior that differs from what was implemented, or use terminology that's clearer in context.

Use the Explore agent or read files directly to understand:
- How users interact with the feature (the public API)
- What the actual defaults and option values are
- Which parts of the spec correspond to internal plumbing vs user-visible behavior

### 3. Rewrite the Spec

Apply these guidelines:

**Remove entirely:**
- File modification tables ("Files Modified")
- Internal symbol declarations (e.g., "Add to CommonSymbols.wl")
- Internal function implementations (e.g., full `toolOptionValue` code with `Enclose`/`ConfirmBy`)
- Serialization/storage mechanism details (e.g., JSON format, environment variable names, parsing logic)
- Verification/test step checklists
- "Goals" sections that describe internal engineering goals rather than user value
- Strikethrough notes about removed plans (e.g., "~~Deprecate the existing...~~ (removed — ...)")

**Keep as-is:**
- Usage examples showing the public API
- Option/parameter tables (name, type, default, description)
- Backward compatibility notes (what changed for existing users)
- Future plans / phase 2 previews (these help users understand direction)

**Simplify rather than remove:**
- Validation behavior → condense to a sentence or two about what happens with bad input (e.g., "Unrecognized names produce warnings but don't cause failure")
- Resolution/priority logic → describe in plain language without internal variable names (e.g., "User-specified value takes priority over built-in default")
- "Implementation notes" under option tables → remove if the table's Description column already conveys the behavior; rewrite to a brief user-facing note if it contains information users need (e.g., that two tools' options are independent of each other)

**Style:**
- Use the same markdown formatting conventions as the original spec
- Keep section headings clear and descriptive
- Don't add new content that wasn't in the original — the goal is reduction, not expansion
- If mentioning an exported symbol users can evaluate (like `$DefaultMCPToolOptions`), keep it; if mentioning an internal symbol (like `$toolOptions` or `parseToolOptions`), remove it

### 4. Summary

After rewriting, briefly tell the user what was removed, what was kept, and what was condensed. This helps them verify nothing important was lost.

Wersje

W bazie nie ma innych skilli o nazwie simplify-spec.

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

  • 90sdlc-specify
    Tworzy lub aktualizuje specyfikację funkcji, czyli co i po co, bez implementacji, w pliku spec.md w katalogu specs.
  • 96simplify-skill
    Upraszcza istniejący skill tak, aby jego zachowanie pozostało bez zmian.
  • 90spec-init
    Tworzy początkową specyfikację projektu w folderze .spec, wyłącznie na wyraźne żądanie użytkownika.
  • 95spec
    Tworzy specyfikację z wymaganiami, scenariuszami i uzasadnieniem projektu, także przy przekształcaniu ADR w specyfikację.
  • 96write-spec
    Pisze lub zmienia specyfikację pomysłu w pliku nazwa-spec.md, zanim zacznie się implementacja.
  • 100simplify-code
    Upraszcza ostatnio zmieniony kod i dokumentację dla ludzi, zachowując fakty i działanie.

Uwagi i zgłoszenia

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