Skills - Framework de Scaffolding e Refatoração de Projetos
bastndev/skills
Scaffolding, melhoria e refatoração segura de projetos com análise arquitetural
Ver no GitHubColeção de skills para Claude que cobre três fases do ciclo de vida de um projeto: inicialização (Start), melhoria contínua (Middle) e auditoria/refatoração (End). Permite criar estruturas production-ready, melhorar projetos durante desenvolvimento e executar refatoração segura com análise profunda de arquitetura.
Instalação
npx convez-ai bastndev/skills1 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
- Inicializar novos projetos com estruturas production-ready
- Executar refatoração segura e auditoria de código existente
- Melhorar performance, segurança e manutenibilidade durante desenvolvimento
- Análise categorizada de problemas arquiteturais com plano faseado de execução
Veredito

Repositório robusto com foco em ciclo de vida completo de projetos. A skill 'end' (refatoração) está funcional; as fases Start e Middle ainda planejadas. Bem documentado em múltiplos idiomas e com suporte a múltiplos runtimes. Ideal para times que precisam de análise estruturada e refatoração segura.
README
A tradução para o português deste README ainda está na fila.
npx skills add https://github.com/bastndev/skills --skill end
The Three Phases
| Phase | Purpose | Key Capabilities | Example Skills | Status |
|---|---|---|---|---|
| Start | Project initialization & scaffolding | Create production-ready folder structures, initialize frameworks, apply best-practice defaults and configs from commit #1. | start-nextjs, start-vite, start-fastapi... | Planned |
| Middle | Continuous improvement & polish | Enhance UI/UX, harden security, boost performance, clean logic, eliminate dead code, improve maintainability — during active development. | Targeted enhancers (TBD) | Planned |
| End | Audit, diagnosis & safe refactoring | Full architecture & quality analysis. Categorized findings with file-level evidence. Prioritized phased plan executed only with explicit approval. Behavior-preserving. Multi-runtime support. | refactor-project (the end skill) | ✅ |
Available Skills
| Skill | Description |
|---|---|
| end | refactor-project — Understands your project end-to-end. Delivers a clear diagnosis (confirmed bugs, risks, opportunities, technical debt) with concrete references. Recommends the right architecture direction for this codebase and builds an ordered execution plan. Every change happens in an isolated, reviewable phase. You stay in full control: the skill only proceeds when you say go, start, or proceed. No files are touched during analysis.→ Full documentation & examples |
Note: Each skill ships with its own detailed README. The root page gives the high-level overview; dive into
./skills/<skill>/README.mdfor deep usage, report examples, and guarantees.
Installation
# Install the End skill (refactor-project)
npx skills add bastndev/skills --skill end
Additional skills (once released) are installed the same way:
npx skills add bastndev/skills --skill start-nextjs
How the End Skill Works
- Analysis first — Maps entry points and understands the project. Zero files are modified.
- Structured report — Clear findings in four categories (Confirmed Bugs with severity, Risks, Refactoring Opportunities, Technical Debt) + an architecture recommendation and ordered plan. All items include concrete file + line references.
- You authorize every phase — It executes exactly one phase at a time. After each phase you get a precise summary of changes, validations performed, and the list of remaining phases.
- Full control & safety — Never creates tests if the project had none. Never adds dependencies or changes the package manager without permission. Respects your uncommitted work and always preserves current behavior unless fixing a justified bug.
For the complete workflow, exact report formats (including the required closing blocks), architecture decision rules, and all safety guarantees, read the dedicated skill documentation:
The full internal specification lives in skills/end/SKILL.md.
Roadmap
- Start skills — One-command project scaffolding for popular stacks (Next.js, Vite, FastAPI, etc.)
- Middle skills — Focused, on-demand improvers (performance, security, UX, dead-code removal, etc.)
- End expansions — More runtimes, additional specialized refactoring modes, and utilities
Each skill will have its own dedicated documentation (like the current End – Refactor Project).
If you find any bugs or have feedback, feel free to open an issue.
Made in 🇵🇪 by Gohit X · Licensed under MIT