Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

simple-issue-description

/simple-issue-description

Przekształca surowe zgłoszenie błędu, prośbę o funkcję lub opis pull requesta w krótkie zgłoszenie prostym językiem, skupione na problemie i oczekiwanym zachowaniu.

Repozytorium
open-seo ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.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
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Przekształca surowe zgłoszenie błędu, prośbę o funkcję lub opis pull requesta w krótkie zgłoszenie prostym językiem, skupione na problemie i oczekiwanym zachowaniu.

Oryginalny opis (EN)

Turn a rough bug report, feature request, support note, or pull request into a short, plain-language issue focused on the problem and desired behavior. Use when a contributor asks to simplify an issue, explain what a PR is for, create the corresponding issue for a PR, remove implementation detail from a report, or invokes /simple-issue-description.

Jak działa

  1. Workflow
  2. Writing rules
  3. Output format
  4. Example
Sekcje z nagłówków SKILL.md, w oryginale · 77 linii, 718 słów
Podgląd SKILL.md
---
name: simple-issue-description
description: Turn a rough bug report, feature request, support note, or pull request into a short, plain-language issue focused on the problem and desired behavior. Use when a contributor asks to simplify an issue, explain what a PR is for, create the corresponding issue for a PR, remove implementation detail from a report, or invokes /simple-issue-description.
---

# Simple Issue Description

Write an issue a maintainer can understand in under a minute. Focus on what someone experiences and what should happen instead.

## Workflow

1. Read the supplied notes, conversation, issue, PR description, or diff. In a PR, also check for spec, design doc, or README changes — they often state the intent better than the description does.
2. Identify the concrete problem. State who or what is affected when the source makes that clear.
3. Describe the desired behavior without prescribing an implementation.
4. Keep only context that helps someone understand or reproduce the problem.
5. If the source is a PR or diff, describe the problem the change tries to solve, not the files or code it changes.
6. Draft the issue immediately unless the problem and desired behavior cannot be determined. In that case, ask one short clarifying question.

One issue per problem. If the source bundles unrelated problems, draft the issue for the most significant one, list the others in a line each, and tell the contributor to split them into separate issues and separate pull requests.

If the source adds a capability instead of fixing a misbehavior, do not stage the absence as a bug. Describe what a user cannot do today and the full user experience of the feature: who uses it, from where, and what they see.

Do not invent user impact, reproduction steps, or certainty that the source does not support. If the source only shows cleanup, refactoring, or a possible code smell, say that no concrete problem is clear instead of manufacturing an issue — this rule wins over step 6. Reply with two or three sentences: what the source shows, and what evidence would make it issue-worthy.

If the source fixes a security weakness that is not already public, do not draft a public issue describing it. Suggest reporting it privately to the maintainer instead.

## Writing rules

- Use plain language and short sentences.
- Keep the issue under 200 words unless it is clear that more is necessary to describe the reproduction steps or a large feature.
- Lead with behavior, not code, architecture, or the proposed fix. A one-sentence plain-language cause is fine when the symptom cannot be understood without it.
- Keep technical details only when they are necessary to reproduce or understand the problem. Limits and defaults that make the symptom make sense (batch sizes, quotas, caps) count as necessary.
- Preserve useful evidence such as error messages, screenshots, links, and documentation references.
- Do not mention that AI wrote or reviewed the issue.
- Avoid filler, praise, roadmap language, and exhaustive edge cases.
- Use the contributor's level of certainty. Do not present a guess as a confirmed bug; write "can" or "appears to" when the source describes a risk rather than an observed failure.

## Output format

The first line is the issue title — when filing on GitHub, put it in the title field instead of repeating it in the body. For a missing capability, title the outcome ("Flag pages with no structured data") rather than a fake bug ("Audits never mention structured data").

Omit the **Extra context** section when there is nothing useful to add. Constraints and scope notes belong there, including what is not affected when a maintainer would reasonably worry that it is.

```markdown
# <Short title describing the problem or desired outcome>

## TL;DR

<In one or two sentences, explain what happens now and what should happen instead.>

## What is happening?

<Describe the current behavior in plain language. Include a concrete example when available.>

## What should happen?

<Describe the desired behavior without proposing how to build it.>

## Extra context

<Optional reproduction steps, error text, screenshots, links, or constraints.>
```

## Example

```markdown
# The chat jumps away from messages I am reading

## TL;DR

When I scroll up to read an older message, a new response moves me back to the bottom of the chat. The chat should stay where I left it until I choose to return to the latest message.

## What is happening?

New responses automatically scroll the chat to the bottom, even when I am reading earlier messages.

## What should happen?

Keep my current scroll position and show that a new message is available.
```
Pliki w paczce (2)
  • SKILL.md 5 KB
  • agents/openai.yaml 1 KB

Wersje

W bazie nie ma innych skilli o nazwie simple-issue-description.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

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

  • 100create-github-issue
    Tworzy zgłoszenia GitHub przez CLI gh: nowe issue, zgłoszenie błędu, prośba o funkcję lub zadanie.
  • 90huddle-bug
    Zamienia opis błędu, link lub surowe zgłoszenie oznaczone „needs triage” w gotowe Bug Issue.
  • 84implement
    Implementuje zgłoszenie z GitHuba zgodnie z planem i tworzy pull request z gotową zmianą.
  • 100create-issue
    Pisze lub przerabia zgłoszenie: tytuł i treść, gdy użytkownik prosi o nowe zgłoszenie albo o poprawę istniejącego.
  • 100descriptions
    Przygotowuje lub poprawia opis pull requesta, gdy użytkownik prosi o PR description, podsumowanie PR lub opis zmiany.
  • 84github-issue
    Zakłada zgłoszenie na GitHubie: błąd, prośbę o funkcję lub dyskusję, także w repozytorium bez lokalnej kopii.

Uwagi i zgłoszenia

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