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

Architecture Cleanup

by udecode in udecode/kitcn

Find and execute bounded architecture cleanup across public exports, package ownership, Convex bundle graphs, plugins, CLI/scaffolds, generated files, docs, and agent navigation.

Apache-2.0Auto-check passedDevelopment

Install Architecture Cleanup

skills CLI
$ npx skills add udecode/kitcn --skill architecture-cleanup -a claude-code

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

GitHub CLI
$ gh skill install udecode/kitcn architecture-cleanup --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/udecode/kitcn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/architecture-cleanup .claude/skills/architecture-cleanup && 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
architecture-cleanup
GitHub stars
450
Token cost
~1.3k tokens
SKILL.md length
647 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
Apache-2.0

At a glance

Find and execute bounded architecture cleanup across public exports, package ownership, Convex bundle graphs, plugins, CLI/scaffolds, generated files, docs, and agent navigation.

  • Works in 7 steps: VISION.md and docs/README.md. → The active goal plan or named source. → Root/package manifests, exports,… → …
  • Tasks that involve Project scaffolding
  • SKILL.md covers Use When, Read Order, Goal Contract and Core Laws, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Architecture Cleanup is an agent skill from udecode/kitcn. Find and execute bounded architecture cleanup across public exports, package ownership, Convex bundle graphs, plugins, CLI/scaffolds, generated files, docs, and agent navigation.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Project scaffolding. The repository describes itself as: Convex + Better Auth + tRPC + Drizzle + TanStack Query + shadcn. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Project scaffolding

Example prompts

  • “/architecture-cleanup”

Workflow steps

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

  1. VISION.md and docs/README.md.
  2. The active goal plan or named source.
  3. Root/package manifests, exports, turbo.json, and build scripts.
  4. Runtime entry points and their static import graphs.
  5. CLI/template source, regeneration commands, fixtures, and scenarios.
  6. User docs and matching packages/kitcn/skills/kitcn/** content.
  7. Tests and proof commands that guard the current contract.

What it can do on your machine

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

Architecture Cleanup loads about 1.3k tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 647 words of instructions outside code blocks.

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

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

The full file from udecode/kitcn at commit c6010f5, republished under its Apache-2.0 licence (© udecode). 647 words, ~1,288 tokens.

Download SKILL.mdSave it as .claude/skills/architecture-cleanup/SKILL.md (or your agent's skills folder).
name
architecture-cleanup
description
Find and execute bounded architecture cleanup across public exports, package ownership, Convex bundle graphs, plugins, CLI/scaffolds, generated files, docs, and agent navigation.
argument-hint
<surface | package | current tree> [plan|execute]

Architecture Cleanup

Use this for structural cleanup whose value comes from removing ownership confusion, duplicate concepts, leaky public APIs, expensive import graphs, or generated-source mistakes. It is not a prettier-file pass.

Use When

  • a concept has multiple owners or multiple public names;
  • package boundaries and exports no longer describe runtime ownership;
  • a Convex function imports a large graph for a narrow operation;
  • plugin, CLI, scaffold, fixture, docs, and runtime shapes disagree;
  • generated files are being edited instead of their source;
  • agents repeatedly need broad searches to locate one responsibility;
  • an old path should be removed with a hard cut.

Use task for a narrow implementation and major-task for a new framework, migration, benchmark, or public-API proposal.

Read Order

  1. VISION.md and docs/README.md.
  2. The active goal plan or named source.
  3. Root/package manifests, exports, turbo.json, and build scripts.
  4. Runtime entry points and their static import graphs.
  5. CLI/template source, regeneration commands, fixtures, and scenarios.
  6. User docs and matching packages/kitcn/skills/kitcn/** content.
  7. Tests and proof commands that guard the current contract.

Goal Contract

Create a goal plan from the architecture-cleanup template with the agent-native pack. Add package-api when a package export or public API is in scope and docs when user docs move.

The plan must state:

  • current and target owner maps;
  • public names being kept, added, or deleted;
  • import-graph and bundle-size consequences;
  • source/generated ownership and regeneration commands;
  • docs and package-skill synchronization;
  • fixtures, scenarios, compatibility stance, and proof gates;
  • deletion receipts and a rollback or safe-stop boundary.

Core Laws

One semantic owner

Each durable concept gets one canonical implementation owner. Adapters may translate at a boundary, but they do not redefine the concept.

Public API is deliberate
  • Trace every public export to a real supported entry point.
  • Remove dead aliases and compatibility shims unless explicitly required.
  • Prefer a small composable API over a monolithic global.
  • A hard cut deletes old exports, docs, tests, examples, and scaffold output.
Convex bundles stay narrow

Convex statically bundles each function entry. Never solve convenience by pulling a monolithic registry, every plugin, or browser-only code into a narrow entry. Prefer per-module callers, plugins, and leaf imports. Prove the relevant entry graph when moving shared code.

Generated output has an owner

Do not patch fixtures, example plugin files, generated skills, or generated root guidance directly. Change the source and regenerate. Record the source, command, and representative generated diff.

Show full SKILL.md (254 more words)Show less
Agent navigation is architecture

A good structure lets an agent find the owner from manifests, exports, docs/README.md, and nearby tests. Penalize duplicated naming, hidden runtime registration, cross-package reach-through, and docs that point to stale paths.

Candidate Method

Inventory concrete candidates before editing:

CandidateCurrent ownerTarget ownerPublic impactBundle impactGenerated impactEvidence

Score only when choosing between valid candidates:

  • correctness and owner clarity;
  • deleted surface and reduced navigation cost;
  • bundle/import-graph improvement;
  • DX and API coherence;
  • proof availability;
  • conflict and migration risk.

Reject cleanup that merely renames files, adds forwarding wrappers, or moves complexity without reducing an owner.

Implementation Packet

Each packet names:

  • one owner and exact files;
  • acceptance behavior;
  • public API and import-graph deltas;
  • generated files and regeneration command;
  • tests, fixtures, scenarios, docs, and skill sync;
  • deletions and forbidden fallback paths;
  • proof required before the next packet.

Use bounded TDD for changed live behavior. Do not write tests whose only purpose is asserting that dead code remains dead.

Closeout

Before completion:

  1. Prove the target owner map from source and exports.
  2. Search for old names, aliases, reach-through imports, and stale docs.
  3. Regenerate every owned artifact and prove no hand-edited drift remains.
  4. Run package build, focused tests, fixtures/scenarios, docs/skill sync, and repository checks required by the changed surface.
  5. Run deslop after behavior works.
  6. Run agent-native-reviewer, then autoreview.
  7. Record deletion receipts, residual risks, and the next owner if incomplete.

Stop rather than inventing a compatibility layer, changing an unrelated public contract, or editing generated output without its owner.

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

Files

Just SKILL.md in .agents/skills/architecture-cleanup of udecode/kitcn.

Open the folder on GitHubat commit c6010f5

Compare with similar skills

Architecture Cleanup 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.

Architecture Cleanup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architecture Cleanup this skilludecode/kitcn450—~1.3kAutomated safety check: PassApache-2.0
Nx Generatenomcopter/react-mosaic4.8k7 repos~1.9kAutomated safety check: PassCustom licence
PonytailDavidObando/gsharp5658 repos~1.7kAutomated safety check: PassMIT
Run Nx Generatornrwl/nx29k2 repos~592Automated safety check: NotesMIT
Conductor Setupgemini-cli-extensions/conductor3.8k—~4.2kAutomated safety check: PassApache-2.0
Mirage VFS Adapter Authoringstrukto-ai/mirage3.7k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Nx Generate

    nomcopter/react-mosaic

    Generate code using nx generators. An agent skill from nomcopter/react-mosaic.

    4.8k GitHub starsUsed in 7 repos~1.9k tokens
    DevelopmentAuto-check passed

  • Ponytail

    DavidObando/gsharp

    Forces the laziest solution that actually works, simplest, shortest, most minimal.

    565 GitHub starsUsed in 8 repos~1.7k tokens
    DevelopmentAuto-check passed

  • Run Nx Generator

    nrwl/nx

    Run Nx generators with prioritization for workspace-plugin generators.

    29k GitHub starsUsed in 2 repos~592 tokens
    DevelopmentAuto-check: notes

  • Conductor Setup

    gemini-cli-extensions/conductor

    Scaffolds the project and sets up the Conductor environment.

    3.8k GitHub stars~4.2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

  • Mirage VFS Adapter Authoring

    strukto-ai/mirage

    Builds or extends a custom Mirage virtual filesystem adapter for an API, database, object store or app data, with a working mount configuration and filesystem tests.

    3.7k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed

  • Siteboon Backend Module Standards

    siteboon/claudecodeui

    Enforces this repository's TypeScript backend module architecture under server/: feature folders, barrel exports, and where shared types and utilities belong.

    14k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed

More from udecode/kitcn

All 33 skills in this repo

  • Walkthrough

    udecode/kitcn

    Create a short annotated visual walkthrough from real final-state screenshots or rendered artifacts.

    450 GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check passed

  • Avoid Feature Creep

    udecode/kitcn

    Prevent feature creep when building software, apps, and AI-powered products.

    450 GitHub stars~2.7k tokensUpdated 6 days ago
    Auto-check passed

  • Changeset Resolve

    udecode/kitcn

    Repair an unreleased .changeset/.md file so it matches the real branch delta against main.

    450 GitHub stars~922 tokensUpdated 6 days ago
    Auto-check passed

  • Convex Release Audit

    udecode/kitcn

    Audit newer Convex npm releases against kitcn. An agent skill from udecode/kitcn.

    450 GitHub stars~1.8k tokensUpdated 6 days ago
    Auto-check passed

  • Jotai X

    udecode/kitcn

    A skill your agent uses when working with Jotai X stores (createAtomStore), accessing state in components or callbacks, persisting state to cookies or localStorage

    450 GitHub stars~3.7k tokensUpdated 6 days ago
    Auto-check passed

  • Linear Backlog

    udecode/kitcn

    Run a scoped Linear backlog autonomously as a sequence of maximal safe parallel batches by composing orchestrator, autogoal, and task.

    450 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check passed

Categories

Questions about Architecture Cleanup

What does Architecture Cleanup do?

Find and execute bounded architecture cleanup across public exports, package ownership, Convex bundle graphs, plugins, CLI/scaffolds, generated files, docs, and agent navigation. Architecture Cleanup is an agent skill from udecode/kitcn. Find and execute bounded architecture cleanup across public exports, package ownership, Convex bundle graphs, plugins, CLI/scaffolds, generated files, docs, and agent navigation.

When should I use Architecture Cleanup?

Architecture Cleanup fits situations like: tasks that involve Project scaffolding.

How do I install Architecture Cleanup in Claude Code?

Run `npx skills add udecode/kitcn --skill architecture-cleanup -a claude-code`. Or copy the skill folder (.agents/skills/architecture-cleanup in udecode/kitcn) into .claude/skills/architecture-cleanup in your project. Claude Code loads it when a task matches its description.

How do I install Architecture Cleanup in Codex?

Run `npx skills add udecode/kitcn --skill architecture-cleanup -a codex`. Or copy the skill folder (.agents/skills/architecture-cleanup in udecode/kitcn) into .agents/skills/architecture-cleanup in your project. Codex loads it when a task matches its description.

Can I use Architecture Cleanup 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 udecode/kitcn --skill architecture-cleanup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architecture-cleanup, .gemini/skills/architecture-cleanup, .github/skills/architecture-cleanup and .opencode/skills/architecture-cleanup in your project.

What does Architecture Cleanup need to run?

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

Does Architecture Cleanup 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 Architecture Cleanup 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 Architecture Cleanup use?

Architecture Cleanup is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Architecture Cleanup use?

About 1.3k tokens (SKILL.md is roughly 5.2k 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 Architecture Cleanup?

Skills that share tags, products or a category with Architecture Cleanup: Nx Generate (nomcopter/react-mosaic, 4.8k stars), Ponytail (DavidObando/gsharp, 565 stars), Run Nx Generator (nrwl/nx, 29k stars) and Conductor Setup (gemini-cli-extensions/conductor, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architecture Cleanup?

udecode (a GitHub organization) maintains it in udecode/kitcn, which has 450 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 1, 2026.

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