Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Pisanie

ste

/ste

Pisze jasny angielski techniczny do dokumentacji, runbooków, komunikatów o błędach i notatek wydania, dla czytelników nienatywnych.

Repozytorium
miru-code ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.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
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.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

Pisze jasny angielski techniczny do dokumentacji, runbooków, komunikatów o błędach i notatek wydania, dla czytelników nienatywnych.

Oryginalny opis (EN)

Clear technical English for docs, runbooks, errors, and release notes. Use when the user says STE, ASD-STE100, /ste, de-slop, write for non-native readers, or asks to rewrite technical prose. Pragmatic by default; strict when they ask for STE compliance. Not for marketing or brand copy. Not for ultra-compressed chat telegraph style.

Jak działa

  1. Activate
  2. Task flow
  3. Modes
  4. Core rules (pragmatic)
  5. Untouchables
  6. Not for marketing
  7. Slop → plain (examples)
  8. Before / after
  9. Self-check (before delivery)
  10. References
Sekcje z nagłówków SKILL.md, w oryginale · 92 linii, 565 słów
Podgląd SKILL.md
---
name: ste
description: >-
  Clear technical English for docs, runbooks, errors, and release notes.
  Use when the user says STE, ASD-STE100, /ste, de-slop, write for non-native
  readers, or asks to rewrite technical prose. Pragmatic by default; strict
  when they ask for STE compliance. Not for marketing or brand copy. Not for
  ultra-compressed chat telegraph style.
---

# STE writing (Simplified Technical English)

On-demand clear technical writing for Miru. **Short complete sentences. Keep articles.**

Unofficial aid inspired by [ASD-STE100](https://www.asd-ste100.org) Issue 9 themes.
**Not ASD-certified. Not ASD-endorsed.** Full dictionary compliance needs the official standard at asd-ste100.org.

Inspired by prior art ([AminBlg/SimpleEnglish](https://github.com/AminBlg/SimpleEnglish), [woosal STE kit](https://github.com/woosal1337/blog/tree/main/videos/ep01-the-cure-for-ai-slop)) — original Miru skill text. Do not vend copyrighted ASD dictionary word lists.

## Activate

| User says | Effect |
|-----------|--------|
| `/ste`, `STE`, `write in STE`, `de-slop this` | ON **pragmatic** (default) |
| `ASD-STE100`, `strict STE`, `STE compliance` | ON **strict** — also load `references/rules.md` |
| Check / audit my STE | Use `references/checklist.md` |

## Task flow

1. Select mode (pragmatic vs strict)
2. Classify text as **procedural** or **descriptive**
3. Pick one consistent term per concept
4. Apply core rules below
5. Run **self-check**
6. Deliver

## Modes

| Mode | Behaviour |
|------|-----------|
| **Pragmatic** (default) | Structural rules + consistent terms. Domain nouns/verbs OK (`webhook`, `deploy`, `commit`). |
| **Strict** | Stricter vocabulary discipline. Tell the user full compliance needs the official ASD dictionary: https://www.asd-ste100.org — then load `references/rules.md`. |

Cite rule numbers **only** when they appear in `references/rules.md`. Do not invent ASD rule IDs.

## Core rules (pragmatic)

- Short **complete** sentences. Keep `a` / `an` / `the` and `that`. No telegraph omission.
- No semicolons — use two sentences.
- **Procedural:** imperative; about 20 words max per sentence; one instruction per sentence; **condition BEFORE command**.
- **Descriptive:** simple tenses; about 25 words max per sentence; one topic per paragraph.
- Active voice; simple tenses; avoid present-perfect stacks and comma "-ing" padding.
- Prefer modals `can` / `will` / `must`. Avoid `should` / `would` / `may` / `might` / `could` in instructions.
- One name per concept in the document (no check/verify/confirm/validate roulette).
- Warnings: state the command or condition first, then the risk.

## Untouchables

Never alter:

- Code fences, identifiers, CLI flags, paths
- Quoted errors, product/API names
- Required safety conditions, limits, versions

If shortening would drop a required qualifier, keep the longer clear sentence.
Miru MCP tool use stays intact when search policy is installed.

## Not for marketing

Do **not** apply STE to marketing, brand, or persuasive copy. Decline and offer a docs-oriented rewrite instead.

## Slop → plain (examples)

| Slop | Plain |
|------|-------|
| It is worth noting that the service is highly robust | The service stays up if the primary node fails |
| You should consider carefully validating the input | You must validate the input |
| Feel free to simply leverage the existing utility | Use the existing utility |

## Before / after

**Before (slop):**
> It is worth noting that you should carefully ensure the migration has completed successfully before you proceed to delete the old volume, as doing so might potentially result in irreversible data loss.

**After (STE pragmatic):**
> Wait until the migration is complete. Then delete the old volume. If you delete the volume too early, you will lose data permanently.

## Self-check (before delivery)

1. Sentences complete with articles where needed?
2. One instruction per procedural sentence; condition before command?
3. Terms consistent; modals are can/will/must where instructions appear?
4. Code, paths, errors, and safety limits untouched?

For a longer audit, read `references/checklist.md`.

## References

- `references/rules.md` — fuller paraphrased rule catalog (strict / audit)
- `references/checklist.md` — extended self-check patterns
Pliki w paczce (3)
  • SKILL.md 4 KB
  • references/checklist.md 1 KB
  • references/rules.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · takara-ai/miru-code100MIT
penpot/penpot100MPL-2.0
mryll/skills100MIT
spheritual/yeschef100Apache-2.0
dualface/ste-zh95MIT
charleshoskinson/foreman85Apache-2.0

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

  • 100ste-simplify
    Zamienia tekst na uproszczony angielski techniczny (STE, zgodny z ASD-STE100) i sprawdza go skryptem.
  • 100ste-writing
    Pisze, przepisuje lub sprawdza techniczną prozę zgodnie z wybranymi regułami ASD-STE100 i lokalnym stylem.
  • 100asd-ste100
    Pisze lub poprawia techniczny angielski w łagodnym lub ścisłym profilu STE, gdy wymagany jest kontrolowany język.
  • 100writing-simple-english
    Pisze lub przepisuje prosty angielski w duchu ASD-STE100: krótkie zdania, strona czynna i jedno słowo na jedno znaczenie.
  • 100simplify-prose
    Pisze i przepisuje techniczne teksty dla czytelników (dokumentacja, README, runbooki, komunikaty błędów, notatki wydania, raporty incydentów, prompty) według zasad STE i sprawdza je pod kątem naruszeń jasności.
  • 100simple-english
    Pisze lub przepisuje tekst prostym angielskim w stylu ASD-STE100: krótkie zdania, czynna strona i jedno znaczenie słowa.

Uwagi i zgłoszenia

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