lov-better-project-structure

lov-better-project-structure is a skill for Claude Code from lovstudio/skills. It costs 40 tokens per session (832 once invoked), scanned A, original, MIT.

A project-structure helper that examines what folders and files are responsible for, then gradually reorganizes them and updates references. It works with projects in any programming language, including single-package projects and monorepos, which are repositories containing multiple related packages.

In plain words
What is it for?
Use it to inspect a project layout, preview a minimal or detailed reorganization, move files, update references, and verify the result with the project's build and relevant tests.
Why use it?
It reduces mixed responsibilities, duplicate layouts, naming conflicts, and scattered tests without relying on a fixed folder pattern. It also helps prevent broken imports, build paths, test discovery, documentation links, or resource references during moves.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the dev-tools plugin — 121 skills shipped together

Good fit Use it to inspect a project layout, preview a minimal or detailed reorganization, move files, update references, and verify the result with the project's build and relevant tests.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/lovstudio/skills/better-project-structure
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add lovstudio/skills --skill better-project-structure
Clone the repo
git clone --depth 1 https://github.com/lovstudio/skills

Made for: Claude Code.

Or install dev-tools, the plugin that ships this one along with the rest of its 121 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for lov-better-project-structure

README.md
[![agentmods](https://agentmods.dev/badge/skills/lovstudio/skills/better-project-structure/github.svg)](https://agentmods.dev/skills/lovstudio/skills/better-project-structure)
Your own site
<a href="https://agentmods.dev/skills/lovstudio/skills/better-project-structure"><img src="https://agentmods.dev/badge/skills/lovstudio/skills/better-project-structure/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for lov-better-project-structure

Your own site · 80×15
<a href="https://agentmods.dev/skills/lovstudio/skills/better-project-structure"><img src="https://agentmods.dev/badge/skills/lovstudio/skills/better-project-structure.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 40 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 832 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00040 $0.00832
Opus 5.5 $0.00016 $0.00333
Sonnet 5.5 $0.00008 $0.00166
Haiku 4.5 $0.00004 $0.00083

Measured 24d ago against content hash 574501892d85, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

lov-better-project-structure scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 24d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/profile_store.py, scripts/validate_skill.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/better-project-structure/SKILL.md · 67 lines

What it actually says

项目整理师 · Project Organizer

分析任意语言项目的目录职责并渐进调整文件结构和引用。

Triggers

Activate when

  • “分析任意语言项目的目录职责并渐进调整文件结构和引用。”
  • “Improve a project directory structure.”

Do not activate when

  • 只是查询本 Skill 的说明,或请求与上述结果无关的任务;不执行实际业务操作。
  • 用户仅要预览或审查时,不进入修改、提交或发布分支。

Execution boundary

自然语言请求即可触发;无需旧 slash 路径、参数插值或指定助手。明确解析当前请求中的 项目、目标文件、选项与输出位置;用当前宿主实际提供的文件、搜索、CLI 和浏览器能力。 项目依赖版本与外部 API 在执行时核实,不能假设示例是现行配置。随包脚本从 Skill 根解析, 业务文件从目标项目根解析。先读当前状态,保护已有未提交内容与其他任务的暂存区。 分析、预览请求保持只读;修改、提交、推送、部署和发布各依当前请求的明确范围执行。 不绕过保护、自动发送消息、强制结束用户进程或抢前台。失败保留可诊断原始错误。

Workflow

  1. 读取 manifest、入口、构建配置、测试与 Git 状态,识别语言、框架、单包或 monorepo。项目现有约定优先,不按固定文件数或目录深度判定质量。

  2. 建立文件职责与依赖图,定位混合职责、重复结构、命名冲突和散落的测试。给出最小迁移映射,支持 minimal、verbose 与仅分析模式。

  3. 先处理低耦合移动,再模块化;同时更新 import、构建路径、测试发现、文档和资源引用。已有 .projectstructure.yaml 只作为用户配置读取,不把示例伪代码当作已实现工具。

  4. 清理前区分源码、构建产物、缓存和用户备份,删除需明确范围,优先可恢复归档;不因文件被忽略就删除 node_modules 或运行中目录。

  5. 运行实际构建与相关测试,逐项回读引用,输出新目录、修改清单与可恢复路径;不虚构健康分、交互界面或性能收益。

Composition

执行前读取 能力组合,按明确制品交接相邻能力。

Runtime context (shared)

运行前读取本包 skill.yaml 与 Profile 合同。优先级为当前请求、 项目上下文、本 Skill records、共享 preferences、brand/user Profile、安全默认值。 只读取声明字段;没有专用运行时的宿主可使用 scripts/profile_store.py 读取共享 Profile。 配置缺失只问影响结果的一个问题。用户明确要求长期保存的值通过该脚本原子写入, 报告实际路径;不保存推断、凭据或其他任务的资料。

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 24d ago Changed 574501892d85
  2. 1mo ago First seen · 67 lines · 40 tokens per session scan A f0cc5485da45

Subscribe to this mod's changes

lov-better-project-structure is a skill published in the GitHub repository lovstudio/skills (72 stars, last pushed 6d ago), licensed MIT. It adds 40 tokens to every session and 832 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-07.

Related

Other skills, from other repositories

mongodb-connection

Optimize MongoDB client connection configuration (pools, timeouts, patterns) for any supported driver language. Use this skill when working/updating/reviewing on functions that instantiate or configure a MongoDB client (eg, when calling connect()), configuring connection pools, troubleshooting connection errors…

fcakyon/claude-codex-settings · 122 tokens

frontend-testing-debugging

Use when testing, debugging, or making targeted improvements to rendered frontend apps through the Frontend Design Skills or web dev plugin: local dev servers, UI regressions, interaction bugs, console errors, responsive layout, and visual QA. Check whether the Browser plugin is available and use it first when it is…

fcakyon/claude-codex-settings · 76 tokens

mongodb-search-and-ai

Guides MongoDB users through implementing and optimizing Atlas Search (full-text), Vector Search (semantic), and Hybrid Search solutions. Use this skill when users need to build search functionality for text-based queries (autocomplete, fuzzy matching, faceted search), semantic similarity (embeddings, RAG…

fcakyon/claude-codex-settings · 132 tokens

workers-best-practices

Cloudflare Workers best practices for production applications. Use when writing, reviewing, or configuring Workers.

fcakyon/claude-codex-settings · 25 tokens

grill-design

Decide a UI design by building several genuinely different working prototypes and comparing them side by side, in rounds, until the choice is locked. Use when asked to "grill the design", "design this screen", "show me options", "prototype some variants", "what should this look like", "I can't decide on a layout".

craigcossairt/trellis · 72 tokens

web-performance-optimization

Audit, diagnose, or optimize website loading and interaction performance, Core Web Vitals, and Lighthouse performance scores.

fcakyon/claude-codex-settings · 27 tokens