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

write-a-skill

/write-a-skill

Tworzy nowe skille agenta z właściwą strukturą, stopniowym ujawnianiem treści i plikami pomocniczymi, na prośbę użytkownika.

Repozytorium
arkenv ↗
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

Tworzy nowe skille agenta z właściwą strukturą, stopniowym ujawnianiem treści i plikami pomocniczymi, na prośbę użytkownika.

Oryginalny opis (EN)

Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.

Jak działa

  1. Process
  2. Skill structure
  3. SKILL.md template
  4. Description requirements
  5. When to add scripts
  6. When to split files
  7. Review checklist
Sekcje z nagłówków SKILL.md, w oryginale · 114 linii, 432 słów
Podgląd SKILL.md
---
name: write-a-skill
description: Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
metadata:
  internal: true
---

# Writing skills

## Process

1. **Gather requirements** - ask user about:
   - What task/domain does the skill cover?
   - What specific use cases should it handle?
   - Does it need executable scripts or just instructions?
   - Any reference materials to include?

2. **Draft the skill** - create:
   - SKILL.md with concise instructions
   - Additional reference files if content exceeds 500 lines
   - Utility scripts if deterministic operations needed

3. **Review with user** - present draft and ask:
   - Does this cover your use cases?
   - Anything missing or unclear?
   - Should any section be more/less detailed?

## Skill structure

```
skill-name/
├── SKILL.md           # Main instructions (required)
├── REFERENCE.md       # Detailed docs (if needed)
├── EXAMPLES.md        # Usage examples (if needed)
└── scripts/           # Utility scripts (if needed)
    └── helper.js
```

## SKILL.md template

```md
---
name: skill-name
description: Brief description of capability. Use when [specific triggers].
---

# Skill Name

## Quick start

[Minimal working example]

## Workflows

[Step-by-step processes with checklists for complex tasks]

## Advanced features

[Link to separate files: See [REFERENCE.md](REFERENCE.md)]
```

## Description requirements

The description is **the only thing your agent sees** when deciding which skill to load. It's surfaced in the system prompt alongside all other installed skills. Your agent reads these descriptions and picks the relevant skill based on the user's request.

**Goal**: Give your agent just enough info to know:

1. What capability this skill provides
2. When/why to trigger it (specific keywords, contexts, file types)

**Format**:

- Max 1024 chars
- Write in third person
- First sentence: what it does
- Second sentence: "Use when \[specific triggers]"

**Good example**:

```
Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.
```

**Bad example**:

```
Helps with documents.
```

The bad example gives your agent no way to distinguish this from other document skills.

## When to add scripts

Add utility scripts when:

- Operation is deterministic (validation, formatting)
- Same code would be generated repeatedly
- Errors need explicit handling

Scripts save tokens and improve reliability vs generated code.

## When to split files

Split into separate files when:

- SKILL.md exceeds 100 lines
- Content has distinct domains (finance vs sales schemas)
- Advanced features are rarely needed

## Review checklist

After drafting, verify:

- [ ] Description includes triggers ("Use when...")
- [ ] SKILL.md under 100 lines
- [ ] No time-sensitive info
- [ ] Consistent terminology
- [ ] Concrete examples included
- [ ] References one level deep

Wersje

RepozytoriumWynikLicencja
Ta strona · yamcodes/arkenv100MIT
borghei/Claude-Skills100MIT
alirezarezvani/claude-skills100MIT
redpanda-data/ui-harness100MIT
RubenGlez/rubstack100MIT
holl4ndtv/skills100MIT
mkurman/zorai100MIT
AmirAzy/HoNspot100MIT
slogsdon/skills-meta-utils100MIT

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

  • 95skill-creator
    Pomaga dodawać i pisać nowe skille od zera oraz poprawiać ich opisy, strukturę i organizację treści z progresywnym ujawnianiem.
  • 100fai-skill-template
    Tworzy pliki SKILL.md zgodne ze specyfikacją Agent Skills, z poprawnym frontmatterem, uporządkowaną treścią i stopniowym ujawnianiem, dla VS Code Copilot, Claude i innych platform agentów.
  • 100claude-skills
    Prowadzi przez tworzenie Agent Skills z progresywnym ujawnianiem i dobrymi praktykami: struktura skilla i progressive disclosure.
  • 95skill-development
    Pomaga tworzyć skille do pluginów Claude Code oraz poprawiać ich opisy, strukturę i organizację treści z progresywnym ujawnianiem.
  • 100add-skill
    Tworzy nowe skille Claude Code z poprawną strukturą, także jako polecenia slash.
  • 90create-skill
    Tworzy lub restrukturyzuje skille agentów: frontmatter, routing opisu i stopniowe ujawnianie treści, na prośbę o napisanie nowego skilla.

Uwagi i zgłoszenia

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