New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Folder Structure

by citypaul in citypaul/.dotfiles

Deprecated compatibility alias for structure-codebase. An agent skill from citypaul/.dotfiles.

Custom licenceAuto-check passedProductivity & Automation

Install Folder Structure

skills CLI
$ npx skills add citypaul/.dotfiles --skill folder-structure -a claude-code

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

GitHub CLI
$ gh skill install citypaul/.dotfiles folder-structure --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/citypaul/.dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/claude/.claude/skills/folder-structure .claude/skills/folder-structure && 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
folder-structure
GitHub stars
739
Token cost
~264 tokens
SKILL.md length
89 words
Files
2
Skills in repo
44
Repo updated
First seen
Licence
Custom licence

At a glance

Deprecated compatibility alias for structure-codebase. An agent skill from citypaul/.dotfiles.

  • Works in 3 steps: Read ../structure-codebase/SKILL.md… → Load the references selected by that… → Do not reproduce or infer the former…
  • Tasks that involve File organization
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Folder Structure is an agent skill from citypaul/.dotfiles. Deprecated compatibility alias for structure-codebase. Activate only for the exact legacy name folder-structure or an explicit $folder-structure invocation. Contains no independent architecture guidance and must delegate to the canonical sibling skill.

Its SKILL.md is about 260 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Productivity & Automation, covering File organization.

When your agent uses it

  • Tasks that involve File organization

Example prompts

  • “/folder-structure”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Read ../structure-codebase/SKILL.md completely and follow it.
  2. Load the references selected by that skill for the current project shape.
  3. Do not reproduce or infer the former protected-domain/ plus sibling-use-cases/ convention.

What it can do on your machine

Read from SKILL.md and the folder at commit cd4028d. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Folder Structure loads about 264 tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 89 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~264

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); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 89 words (~264 tokens).

“The former screaming-architecture guidance under this name has been retired. structure-codebase is the sole authoritative skill for physical code organization and dependency-boundary design.”

— opening of SKILL.md by citypaul, Custom licence
name
folder-structure
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in claude/.claude/skills/folder-structure of citypaul/.dotfiles.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit cd4028d

Compare with similar skills

Folder Structure 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.

Folder Structure compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Folder Structure this skillcitypaul/.dotfiles739—~264Automated safety check: PassCustom licence
Answer Me With HTMLQingYunA/answer-me-with-html2.1k—~4kAutomated 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.6kAutomated safety check: PassMIT
PikpakBengerthelorf/pikpaktui120—~1.2kAutomated safety check: PassApache-2.0

Similar skills

  • Answer Me With HTML

    QingYunA/answer-me-with-html

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

    2.1k GitHub stars~4k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • 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 today
    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.6k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • Pikpak

    Bengerthelorf/pikpaktui

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

    120 GitHub stars~1.2k tokensUpdated 2 mo 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 citypaul/.dotfiles

All 44 skills in this repo

  • Find Skills

    citypaul/.dotfiles

    Discover and, with authorization, install agent skills from the open skills ecosystem.

    739 GitHub stars~2.5k tokensUpdated 5 days ago
    Auto-check passed

  • Render Code Shape

    citypaul/.dotfiles

    Render the shape of code — module boundaries, the types that cross them, signatures, and a cited call graph — for code that already exists or a change about to be built.

    739 GitHub stars~2.5k tokensUpdated 5 days ago
    Auto-check passed

  • Structure Codebase

    citypaul/.dotfiles

    Design, audit, and evolve physical source and package structures that expose real architectural boundaries while keeping related behavior together.

    739 GitHub stars~4.4k tokensUpdated 5 days ago
    Auto-check passed

  • Test Design Reviewer

    citypaul/.dotfiles

    Review test quality using Dave Farley's eight properties of good tests.

    739 GitHub stars~1k tokensUpdated 5 days ago
    Auto-check passed

  • Characterisation Tests

    citypaul/.dotfiles

    A skill your agent uses when modifying existing code that lacks tests and you need to document its actual current behavior before making changes -- the legacy code dilemma where you need tests to…

    739 GitHub stars~3.6k tokensUpdated 5 days ago
    Auto-check passed

  • CI Debugging

    citypaul/.dotfiles

    Systematic CI/CD failure diagnosis using hypothesis-first investigation, local reproduction, and environment delta analysis.

    739 GitHub stars~1.5k tokensUpdated 5 days ago
    Auto-check: notes

Categories

Questions about Folder Structure

What does Folder Structure do?

Deprecated compatibility alias for structure-codebase. An agent skill from citypaul/.dotfiles. dotfiles. Deprecated compatibility alias for structure-codebase.

When should I use Folder Structure?

Folder Structure fits situations like: tasks that involve File organization.

How do I install Folder Structure in Claude Code?

Run `npx skills add citypaul/.dotfiles --skill folder-structure -a claude-code`. Or copy the skill folder (claude/.claude/skills/folder-structure in citypaul/.dotfiles) into .claude/skills/folder-structure in your project. Claude Code loads it when a task matches its description.

How do I install Folder Structure in Codex?

Run `npx skills add citypaul/.dotfiles --skill folder-structure -a codex`. Or copy the skill folder (claude/.claude/skills/folder-structure in citypaul/.dotfiles) into .agents/skills/folder-structure in your project. Codex loads it when a task matches its description.

Can I use Folder Structure 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 citypaul/.dotfiles --skill folder-structure -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/folder-structure, .gemini/skills/folder-structure, .github/skills/folder-structure and .opencode/skills/folder-structure in your project.

What does Folder Structure need to run?

SKILL.md names no scripts, command-line tools or credentials: Folder Structure is instructions for the agent only.

Does Folder Structure 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 Folder Structure 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. Review the folder before installing.

What licence does Folder Structure use?

Folder Structure has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Folder Structure use?

About 264 tokens (SKILL.md is roughly 1.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Folder Structure?

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

Who maintains Folder Structure?

citypaul (a GitHub user) maintains it in citypaul/.dotfiles, which has 739 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 2, 2026.

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