Agent skill

File Organization Governance

by Peiiii in Peiiii/nextclaw

当新增、重命名、移动文件,改变文件角色/feature root/目录边界,或用户明确要求命名、文件组织和目录概况治理时使用;统一路由命名、角色、feature-root 和概况扫描,局部修改现有文件不触发。

MITAuto-check passedProductivity & Automation

Install File Organization Governance

skills CLI
$ npx skills add Peiiii/nextclaw --skill file-organization-governance -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Peiiii/nextclaw file-organization-governance --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Peiiii/nextclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/wiki/skills/governance/file-organization-governance .claude/skills/file-organization-governance && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
file-organization-governance
GitHub stars
260
Token cost
~309 tokens
SKILL.md length
59 words
Files
10 (incl. scripts, references)
Skills in repo
70
Repo updated
First seen
Licence
MIT

At a glance

当新增、重命名、移动文件,改变文件角色/feature root/目录边界,或用户明确要求命名、文件组织和目录概况治理时使用;统一路由命名、角色、feature-root 和概况扫描,局部修改现有文件不触发。

  • Tasks that involve File organization
  • SKILL.md covers 入口判断, 共同规则, 自动检查 and 输出
  • Runs JavaScript scripts from its folder; calls pnpm

What it does

File Organization Governance is an agent skill from Peiiii/nextclaw. 当新增、重命名、移动文件,改变文件角色/feature root/目录边界,或用户明确要求命名、文件组织和目录概况治理时使用;统一路由命名、角色、feature-root 和概况扫描,局部修改现有文件不触发。

Its SKILL.md is about 310 tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `demo.md`, `references/feature-root.md` and `references/file-naming-spec.md`).

It sits in Productivity & Automation, covering File organization. The repository describes itself as: A human-centered long-term AI partner—not a task-centered assistant. The licence is MIT.

When your agent uses it

  • Tasks that involve File organization

Example prompts

  • “/file-organization-governance”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 4d9d500. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

File Organization Governance loads about 309 tokens when it runs, and up to ~8.9k if it reads all its reference files. Until then it costs about 33 tokens; SKILL.md has 59 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~309
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Peiiii/nextclaw at commit 4d9d500, republished under its MIT licence (© Peiiii). 59 words, ~309 tokens.

Download SKILL.mdSave it as .claude/skills/file-organization-governance/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
file-organization-governance
description
当新增、重命名、移动文件,改变文件角色/feature root/目录边界,或用户明确要求命名、文件组织和目录概况治理时使用;统一路由命名、角色、feature-root 和概况扫描,局部修改现有文件不触发。

文件组织治理

入口判断

先选择一个当前模式,不批量读取全部参考:

  • 新增/重命名/移动文件、角色后缀或 kebab-case:读取 命名合同;完整规格仅在规则歧义时再读 命名规格。
  • 判断 service/store/utils/config/types、假角色或 barrel:读取 文件角色。
  • 判断单 feature root、features、shared、contributions、跨包公共入口:读取 Feature Root。
  • 用户只要目录热点、问题量化和治理优先级:读取 目录概况,不直接重构。

同一决策只读取一个模式;只有前一模式明确暴露另一个独立问题时才继续。

共同规则

  • 先角色、再领域、再层级;没有真实复杂度不展开模板目录。
  • 文件名表达主要职责,目录和后缀一致;禁止 common/misc/general 等模糊垃圾桶。
  • 角色冲突检查只提出问题,不预设修复方向:必须同时评估“增强实现以成为真实角色 owner”和“按现状改名/移动”两个候选,比较职责收益、状态与生命周期封装、复用与测试价值、调用方成本和新增抽象负担;禁止默认选择改动最小的一边。
  • 一个 feature root 内优先内聚;只有稳定跨 feature 复用才进入 shared。
  • 跨 workspace 依赖只走公共入口或 exports,不用消费者 alias 绕过边界。
  • 新增、重命名、移动或角色边界变化前运行 pnpm preflight:governance -- <planned-paths...>。
  • 局部修改现有文件不重复运行 planned-path preflight,也不加载本 skill。

自动检查

现有目录扫描与重构脚本位于 scripts/。脚本结果是结构事实信号,不替代 role/feature owner 判断,也不能决定是升级实现还是修正命名;自动改写前先确认范围且不得触碰无关 WIP。

输出

说明当前模式、目标路径、角色/feature 判断、preflight 结果和明确不改的范围。不要同时复述四份 reference。

© Peiiii, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (scripts, references) in .agents/wiki/skills/governance/file-organization-governance of Peiiii/nextclaw.

  • SKILL.md
  • demo.md
  • references/feature-root.md
  • references/file-naming-spec.md
  • references/file-roles.md
  • references/naming.md
  • references/overview.md
  • scripts/check-organization.js
  • scripts/enhanced-check-organization.js
  • scripts/refactor-organization.js

Open the folder on GitHubat commit 4d9d500

Compare with similar skills

File Organization Governance next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

File Organization Governance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
File Organization Governance this skillPeiiii/nextclaw260—~309Automated safety check: PassMIT
Abp App Nolayersabpframework/abp14k—~575Automated safety check: PassLGPL-3.0
Feishu Driveraucvr/Group-Goki1123 repos~587Automated safety check: PassMIT
Azldev Comp Tomlmicrosoft/azurelinux5.3k—~1.8kAutomated safety check: PassMIT
Answer Me With HTMLOWWZO/ai-agent1891 repos~4.1kAutomated safety check: PassMIT
PikpakBengerthelorf/pikpaktui121—~1.2kAutomated safety check: PassApache-2.0

Similar skills

  • Abp App Nolayers

    abpframework/abp

    ABP Single-Layer (No-Layers / nolayers) application template - single project structure, feature-based file organization, no separate Domain/Application.Contracts projects.

    14k GitHub stars~575 tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Feishu Drive

    raucvr/Group-Goki

    Feishu cloud storage file management. An agent skill from raucvr/Group-Goki.

    112 GitHub starsUsed in 3 repos~587 tokens
    Productivity & AutomationAuto-check passed
  • Azldev Comp Toml

    microsoft/azurelinux

    Official

    Read this before authoring, editing, or reviewing a .comp.toml file; do not work from memory.

    5.3k GitHub stars~1.8k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Answer Me With HTML

    OWWZO/ai-agent

    Turns an answer into a one-page visual HTML explainer: the model writes a short Markdown draft and the bundled CLI builds one page.

    189 GitHub starsUsed in 1 repo~4.1k tokens
    Productivity & AutomationAuto-check passed
  • Pikpak

    Bengerthelorf/pikpaktui

    Manage PikPak cloud storage — browse, upload, download, stream, share, and organize files via CLI.

    121 GitHub stars~1.2k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Advanced File Management

    MassLab-SII/open-agent-skills

    Advanced file management tools. An agent skill from MassLab-SII/open-agent-skills.

    133 GitHub stars~1.6k tokensUpdated 9 mo ago
    Productivity & AutomationAuto-check passed

More from Peiiii/nextclaw

All 70 skills in this repo
  • Nextclaw Skin Studio

    Peiiii/nextclaw

    A skill your agent uses when a user wants to browse, apply, inspect, create, refine, switch, or remove a NextClaw skin; wants a personal skin with arbitrary CSS, JavaScript, images, SVG, DOM…

    260 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when a development task needs visible phase tracing, task-level or phase-level Token measurement, model/effort comparison, or a deterministic usage report or local dashboard…

    260 GitHub stars~802 tokensUpdated yesterday
    Auto-check passed
  • 当 NextClaw 产品更新后需要生成、替换、挑毛病或检查官网、GitHub README、用户文档或社交传播中的真实截图、AI 宣传视觉、整页 HTML 宣传预览、社区二维码等对外视觉资产时使用;也用于“更新截图”“重新截一批图”“做宣传页”“生成 campaign 页面”“视觉审稿”“五星挑刺法”或发布前检查视觉资产。普通站点布局开发或只写文章不触发。

    260 GitHub stars~801 tokensUpdated yesterday
    Auto-check passed
  • UI UX Pro Max

    Peiiii/nextclaw

    A skill your agent uses when the user wants professional UI/UX design guidance, design-system generation, UX review, or stack-specific frontend guidance through a bundled local UI/UX Pro Max dataset…

    260 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Impeccable

    Peiiii/nextclaw

    A skill your agent uses when the user wants distinctive, production-grade frontend design, anti-generic AI aesthetics, UX critique, technical UI audits, or final polish through bundled Impeccable…

    260 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Curate NextClaw skill resources, including OpenClaw and community sources.

    260 GitHub stars~479 tokensUpdated yesterday
    Auto-check passed

Questions about File Organization Governance

What does File Organization Governance do?

当新增、重命名、移动文件,改变文件角色/feature root/目录边界,或用户明确要求命名、文件组织和目录概况治理时使用;统一路由命名、角色、feature-root 和概况扫描,局部修改现有文件不触发。. File Organization Governance is an agent skill from Peiiii/nextclaw.

When should I use File Organization Governance?

File Organization Governance fits situations like: tasks that involve File organization.

How do I install File Organization Governance in Claude Code?

Run `npx skills add Peiiii/nextclaw --skill file-organization-governance -a claude-code`. Or copy the skill folder (.agents/wiki/skills/governance/file-organization-governance in Peiiii/nextclaw) into .claude/skills/file-organization-governance in your project. Claude Code loads it when a task matches its description.

How do I install File Organization Governance in Codex?

Run `npx skills add Peiiii/nextclaw --skill file-organization-governance -a codex`. Or copy the skill folder (.agents/wiki/skills/governance/file-organization-governance in Peiiii/nextclaw) into .agents/skills/file-organization-governance in your project. Codex loads it when a task matches its description.

Can I use File Organization Governance in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Peiiii/nextclaw --skill file-organization-governance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/file-organization-governance, .gemini/skills/file-organization-governance, .github/skills/file-organization-governance and .opencode/skills/file-organization-governance in your project.

What does File Organization Governance need to run?

Going by SKILL.md and its folder, File Organization Governance needs JavaScript for the scripts in its folder and the command-line tools its instructions call (pnpm). Our summary lists: Node.js.

Does File Organization Governance access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is File Organization Governance safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does File Organization Governance use?

File Organization Governance is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does File Organization Governance use?

About 309 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.6k tokens, read only when the agent opens those files.

What are the alternatives to File Organization Governance?

Skills that share tags, products or a category with File Organization Governance: Abp App Nolayers (abpframework/abp, 14k stars), Feishu Drive (raucvr/Group-Goki, 112 stars), Azldev Comp Toml (microsoft/azurelinux, 5.3k stars) and Answer Me With HTML (OWWZO/ai-agent, 189 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains File Organization Governance?

Peiiii (a GitHub user) maintains it in Peiiii/nextclaw, which has 260 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 9, 2026.

Source: Peiiii/nextclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.