Claude Code Skills — Workflow de Desenvolvimento Dirigido por IA
ArturWilczek/claude-skills-1
Orquestra desenvolvimento full-stack com agentes IA especializados
Ver no GitHubConjunto de skills especializados para Claude Code que implementam um workflow repetível onde agentes IA atuam como membros de equipe (planejador, executor, technical writer, secretário) enquanto humanos focam em arquitetura e requisitos. Inclui skills para atualizar tarefas, executar implementações, gerar documentação de API e guias de usuário.
Instalação
npx convez-ai ArturWilczek/claude-skills-11 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar planejamento e execução de tarefas de desenvolvimento com rastreamento em TASKS.md
- Gerar e manter documentação de API sincronizada com o código em tempo real
- Implementar workflow repetível com especificações em SPEC.md, planos em _TASKS/ e guias de usuário
Veredito

Excelente abordagem para equipes que usam Claude Code — estrutura clara de skills especializados reduz overhead de contexto e permite paralelização de tarefas. Requer disciplina na convenção de arquivos e documentação, mas entrega ROI alto em projetos médios/grandes.
README
A tradução para o português deste README ainda está na fila.
Claude Code Skills — AI-Driven Development Workflow
Zestaw SKILL-i Claude Code, które posłużyły do zbudowania i utrzymania realnej aplikacji w ramach AI-Driven Development Workflow — powtarzalnego procesu, w którym agenci AI pełnią rolę wyspecjalizowanych członków zespołu (planista, wykonawca, technical writer, sekretarz), a człowiek skupia się na architekturze, wymaganiach i weryfikacji.
Pełny opis procesu, kontekst powstania każdego SKILL-a oraz wnioski z pracy znajdziesz w artykule: 👉 AI-Driven Development Workflow
SKILL-e powstały przy okazji aplikacji CPW (rejestrowanie pomiarów ciśnienia, pulsu i wagi), ale są na tyle ogólne, że nadają się do większości projektów prowadzonych z Claude Code. Część z nich zakłada konwencję plików
SPEC.md/CLAUDE.md/TASKS.md/API.md/GUIDE.mdopisaną w artykule — dostosuj je do własnego projektu, jeśli używasz innych nazw.
Zawartość
| SKILL | Rola | Opis |
|---|---|---|
update-tasks-list | Planista | Czyta specyfikację (SPEC.md, CLAUDE.md) i dopisuje do TASKS.md zadania ułożone logicznie — od bazy danych, przez REST API, po frontend. Dla każdego zadania tworzy plik planu w _TASKS/NNNN.md. |
do-task | Wykonawca | Realizuje zadanie o podanym numerze zgodnie z planem w _TASKS/NNNN.md, a po zakończeniu aktualizuje jego status w TASKS.md. |
update-task | Korygujący | Aktualizuje plik zadania NNNN.md o nowe wymagania (nowa funkcja, rozbudowa, poprawka) i od razu wprowadza zmianę w kodzie. |
update-spec | Analityk biznesowy | Wbudowuje nową funkcjonalność / zmianę koncepcyjną w SPEC.md (i w razie potrzeby CLAUDE.md), dbając o spójność dokumentów. |
cleanup-spec | Porządkowy | Usuwa duplikacje między SPEC.md, CLAUDE.md i plikami zewnętrznymi (np. API.md), porządkuje strukturę i odchudza kontekst. |
update-api-doc | Technical writer (API) | Tworzy lub aktualizuje API.md — kompletną dokumentację endpoint-ów REST API (URL, metoda, dane wejściowe, autoryzacja, opis biznesowy). |
update-user-guide | Technical writer (użytkownik) | Tworzy lub aktualizuje GUIDE.md — instrukcję dla użytkownika końcowego ze zrzutami ekranów wykonanymi przez Playwright na danych testowych. |
commit-staged | Sekretarz | Przygotowuje commit message (po polsku) dla plików w statusie staged, wykonuje commit, a na końcu zawsze pyta, czy zrobić git push. |
Pętla rozwojowa
Główna:
pomysł → /update-spec → /update-tasks-list → /do-task <nr> → (/update-task <nr> <opis>)* → /commit-staged
Pomocnicza:
↘ /update-api-doc, /update-user-guide (regularnie)
↘ /cleanup-spec (okresowo)
Instalacja
SKILL-e instalujesz jednym poleceniem za pomocą npx skills — menedżera skilli dla agentów AI (Claude Code, Cursor, Codex i inne). Uruchom je w katalogu swojego projektu.
Cały zestaw
npx skills add ArturWilczek/claude-skills-1
Polecenie wyświetli listę dostępnych SKILL-i — zaznacz wszystkie lub wybierz interesujące Cię.
Pojedynczy SKILL
npx skills add ArturWilczek/claude-skills-1 --skill commit-staged
Wszystkie bez pytania (np. w CI)
npx skills add ArturWilczek/claude-skills-1 --all
SKILL-e trafiają do .claude/skills/<nazwa>/SKILL.md w Twoim projekcie. Aby zainstalować je globalnie (dla wszystkich projektów), dodaj flagę --global.
Użycie
Uruchom (lub zrestartuj) Claude Code w katalogu projektu i wywołaj wybrany SKILL poleceniem /<nazwa-skilla>:
/update-tasks-list
/do-task 1
/update-task 4 Przycisk submit ma być nieaktywny gdy formularz niepoprawny
/commit-staged
Konwencje plików projektu
Część SKILL-i zakłada następujący podział dokumentacji (możesz go dostosować, edytując pliki SKILL.md):
SPEC.md— warstwa biznesowa i funkcjonalna: co robi aplikacja.CLAUDE.md— warstwa techniczna i pamięć projektu: jak agent ma pracować z kodem (generowany przez wbudowane/init).TASKS.md+_TASKS/NNNN.md— lista zadań i szczegółowe plany realizacji.API.md— pełna dokumentacja endpoint-ów REST API.GUIDE.md— instrukcja dla użytkownika końcowego.
Licencja
Projekt jest dostępny na licencji MIT — możesz go używać, kopiować, modyfikować i redystrybuować, także komercyjnie, zachowując notę o autorstwie. Jeśli SKILL-e okażą się pomocne — daj znać lub podlinkuj artykuł. 🙌