Español 🇪🇸 | 中文 🇨🇳 | Deutsch 🇩🇪 | Français 🇫🇷 | 日本語 🇯🇵 | 한국어 🇰🇷 | Português 🇧🇷 | Русский 🇷🇺 | Tiếng Việt 🇻🇳 | हिन्दी 🇮🇳 | العربية 🇸🇦...
Bootstrap new projects with confidence. Iteratively refine and harden them as they grow. Perform deep, safe refactoring when the architecture needs to evolve.
npx skills add bastndev/skills
| Phase | Purpose | Key Capabilities | Example Skills | Status |
|---|---|---|---|---|
| Start | Begin a project — scaffold new, or learn from an existing one | Create production-ready structures and configs from commit #1. Or analyze an existing codebase's architecture & packages and document it, so you can reuse what works in your own project. | start-package, start-astro, skrapi |
ㅤㅤ✅ |
| Middle | Continuous improvement & polish | Score the project (0–100 health overview), then improve one dimension at a time — performance, UI/UX, tidy (file order + comment hygiene), security, structure, cleanup, or code quality — with a focused plan executed only on your go. |
middle |
ㅤㅤ✅ |
| 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. | end |
ㅤㅤ✅ |
Listed in the natural order you'd reach for them — Start something new (or study an existing codebase for inspiration), refine it in the Middle, and harden it at the End.
| Skill | Description |
|---|---|
| start-package | Start — Scaffolds a publishable dual ESM + CJS TypeScript package with bundled type declarations, a zero-config tsup build, and TypeScript pinned to 5.x so it builds cleanly in both CLI and editor. Generates package.json, tsconfig.json, tsup config, a smoke test, and .vscode settings, then installs, builds, and verifies.→ Full documentation |
| start-astro | Start — Scaffolds a new Astro project using the minimal template, overlaid with a clean, scalable architecture — ready to grow from a portfolio to a full app. Sets up a shared layout, header, footer, pages, light/dark theme toggle, native View Transitions, path alias, and Content Collections out of the box.→ Full documentation |
| skrapi | Start — Point it at a project you admire and it maps how that codebase is built into a fixed SKRAPI/ folder of focused Markdown — architecture, dependencies, and paste-ready prompts — so you can borrow the patterns that fit your own project before you start. Works on any stack (web, mobile, extension, library, monorepo); every description is verified against real code, never guessed from a package name. Multilingual output (🇪🇸 ES · 🇺🇸 EN · 🇨🇳 ZH).→ Full documentation |
| middle | Middle — Numbered, on-demand improvers for active development. 0 scores your project or folder with a 0–100 health overview and points at the weakest area; 1–7 each qualify one dimension (⚡ performance · 🎨 ui-ux · 🗂️ tidy · 🔒 security · 🏗️ structure · 🧹 cleanup · 🧩 quality), report evidence-backed findings, and propose a correction plan — executed phase by phase only when you say go.→ Full documentation |
| end | End — 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 — it only proceeds when you say go, start, or proceed, and no files are touched during analysis.→ Full documentation & examples |
| l10n-sync | Utility — The disciplined, token-efficient localization skill. Syncs translated assets with the English source of truth without full-file retranslation. Ensures invariants (code, HTML) and exact structures are preserved across 11 languages. → Full documentation |
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.
Every skill installs the same way — pick the one you need:
npx skills add bastndev/skills --skill start-package # Start — scaffold a TS npm package
npx skills add bastndev/skills --skill start-astro # Start — scaffold an Astro project
npx skills add bastndev/skills --skill skrapi # Start — study & document any codebase
npx skills add bastndev/skills --skill middle # Middle — score & improve one dimension
npx skills add bastndev/skills --skill end # End — audit & safely refactor
npx skills add bastndev/skills --skill l10n-sync # Utility — sync localized assets safelyend is the most mature skill in the suite. Here's its workflow end to end:
- Analysis first — Maps entry points and understands the project. Zero files are modified.
- Structured report — Clear findings categorized into Bugs (with severity), Debt/Risks, and Suggestions, plus a scored health overview, an architecture recommendation, and an ordered plan — all backed by 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.
- Start —
start-package(scaffold),start-astro(Astro scaffold) andskrapi(study an existing codebase) ship today; morestart-*scaffolders are on the way. - Middle —
middleships today (health overview + six numbered focus improvers); deeper per-focus tooling is planned. - End —
endships today; more runtimes, additional specialized refactoring modes, and utilities are planned. - Utility —
l10n-syncships today for disciplined, token-efficient workspace localization.
Each skill ships with its own dedicated documentation (like the current End – Refactor Project).
Built for developers who want their AI agents to act with the discipline of a senior engineer.
If you find any bugs or have feedback, feel free to open an issue.