{"slug": "i-built-a-claude-skill-that-reviews-your-sveltekit-project-structure-like-a", "title": "I built a Claude skill that reviews your SvelteKit project structure like a senior architect", "summary": "A developer built a Claude skill that reviews SvelteKit project structures like a senior architect. The skill offers two modes: designing a structure from scratch based on project scale and team, and reviewing existing projects with detailed reports including weaknesses, architecture scores, and migration plans. It focuses on SvelteKit-specific conventions like server/client boundaries and runes, and is available via GitHub and the skills CLI.", "body_md": "Every SvelteKit project I have worked on hits the same wall around the twentieth route. The app runs fine, but nobody can answer a simple question anymore: where does this file go? Business logic slips into `+page.server.ts`\n\n, a `utils.ts`\n\ngrows to 600 lines, and one day you find a database client imported straight into a component.\n\nThere is a lot of advice out there about folder structure, but most of it is either a beginner tutorial or a single opinionated layout presented as the only right answer. Real projects are messier than that. A structure that is perfect for a three route side project is wrong for a forty engineer platform, and the reverse is also true.\n\nSo I built a Claude skill that treats project structure the way a senior architect would: it asks about your scale and team, explains tradeoffs instead of handing down rules, and never pretends there is one correct layout.\n\nThe skill works in two modes.\n\n**Design from scratch.** It does not jump straight to a folder tree. It first asks about the size, the team, the domain, and how long the project needs to live, then recommends the simplest structure that will not need reworking too soon. Over engineering a small app is just as costly as under engineering a large one.\n\n**Review an existing project.** This is where it earns its keep. It traces a feature end to end, probes the server and client boundary, runs a checklist, and produces a report with an executive summary, strengths, weaknesses ordered by impact, an architecture score from one to ten, immediate and long term improvements, a suggested folder tree, a migration plan, risks, and a final recommendation.\n\nHere is a taste of the weaknesses section from a review of a messy sample app:\n\n```\n- [Critical] Server/client boundary leak. lib/stripe.ts uses the secret and is\n  imported inside a component. Risk of shipping credentials to the browser.\n- [High] Per-user state in module scope. lib/store.ts exports currentUser at\n  module level, which leaks data between users on the server.\n- [Medium] God utility. utils.ts (600 lines) mixes dates, currency, DB helpers,\n  fetch, and DOM. A dependency and cycle magnet.\n```\n\nEach finding comes with where it shows up, why it will hurt as the project grows, and how to fix it incrementally so the app stays deployable at every step.\n\nGeneric frontend advice does not help here, because SvelteKit's conventions are load bearing. The `$lib/server`\n\nboundary is a real security guarantee enforced by the build. The `$env`\n\nmodules decide what can reach the browser. Route groups organize the URL tree without adding segments. Runes changed how shared state is organized. The skill is built around these mechanics, and it labels features as stable, experimental, or deprecated so the guidance stays honest as the framework evolves.\n\nIt also avoids hardcoding version numbers and links to the official docs throughout, so it does not rot every time a new version ships.\n\nThe skill lives on GitHub and installs with a single command through the [skills](https://skills.sh) CLI, which works with Claude Code and other agents:\n\n```\nnpx skills add poolcamacho/sveltekit-project-structure\n```\n\nThen just ask naturally. Things like \"review the structure of my SvelteKit app\", \"where should this billing logic live?\", or \"design a folder layout for a multi tenant SvelteKit SaaS\" all trigger it.\n\nTwo principles run through the whole thing.\n\nFirst, maintainability over cleverness. A layout a new teammate can navigate in ten minutes beats an elegant one only its author understands.\n\nSecond, fit over dogma. No single architecture is universally correct, so every recommendation comes with why it exists, when to apply it, when not to, and the alternatives.\n\nThe code and the full reference material are on GitHub: [poolcamacho/sveltekit-project-structure](https://github.com/poolcamacho/sveltekit-project-structure). If you try it on a real project, I would love to hear what score it gave you and whether the migration plan held up.", "url": "https://wpnews.pro/news/i-built-a-claude-skill-that-reviews-your-sveltekit-project-structure-like-a", "canonical_source": "https://dev.to/poolcamacho/i-built-a-claude-skill-that-reviews-your-sveltekit-project-structure-like-a-senior-architect-44g9", "published_at": "2026-07-13 16:49:29+00:00", "updated_at": "2026-07-13 17:17:13.573428+00:00", "lang": "en", "topics": ["developer-tools", "artificial-intelligence", "ai-tools"], "entities": ["Claude", "SvelteKit", "GitHub", "skills.sh", "poolcamacho/sveltekit-project-structure"], "alternates": {"html": "https://wpnews.pro/news/i-built-a-claude-skill-that-reviews-your-sveltekit-project-structure-like-a", "markdown": "https://wpnews.pro/news/i-built-a-claude-skill-that-reviews-your-sveltekit-project-structure-like-a.md", "text": "https://wpnews.pro/news/i-built-a-claude-skill-that-reviews-your-sveltekit-project-structure-like-a.txt", "jsonld": "https://wpnews.pro/news/i-built-a-claude-skill-that-reviews-your-sveltekit-project-structure-like-a.jsonld"}}