skilld
All skills
lexler avatar

/refactoring-team

@628d2e9
by Lada Kesselerlexler/skill-factory238 stars
61

Iterative code refactoring through progressive lenses via a worker-reviewer agent team.

Ask your Agent

Use this Skill: https://skilld.dev/gh/lexler/skill-factory/refactoring-team

This session only. Nothing lands on disk.

referenceslenses09-structural-storytelling.md

≈256 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Lens: Structural Storytelling

Code structure should tell a story. A reader should understand what the code does by how it's organized, before reading the details.

The Question

Does the structure of this code tell its story? Can someone understand the flow without jumping around?

The Narrative Hierarchy

Code should read from high-level to low-level:

  1. Entry points — public API, main orchestration (what this code DOES)
  2. Direct helpers — functions that entry points call
  3. Utilities — low-level operations, foundational functions

How to Spot

  • Entry points buried in the middle or bottom of files
  • Helper functions defined before the functions that use them
  • Having to scroll up and down to understand the flow
  • Implementation details appearing before the big picture

The Test

Cover the bottom half of the file. Can you understand what the code does from just the top?

Go Deeper

What else obscures the story? What structural changes would make the narrative clearer?

Source: SKILL.md on GitHub

Third-party checks

No alerts6d3 checks · Risk SAFE
  • Gen Agent Trust Hub6d

    The skill facilitates an automated, iterative refactoring workflow using a worker-reviewer agent team. It processes local source code and executes user-provided test commands to verify changes. The skill operates using local scripts and standard development tools without any detected malicious behaviors or obfuscation.

  • Socket6d

    No alerts

  • Snyk6d

    Risk: LOW · No issues

Provenance

Signed by skilld at 628d2e9. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 7 months ago

Capability

disable-model-invocation
true
argument-hint
[target-path]
Other metadata
hooks
{
  "TeammateIdle": [
    {
      "hooks": [
        {
          "type": "command",
          "command": "${CLAUDE_SKILL_DIR}/references/guard-idle-worker.sh"
        }
      ]
    }
  ]
}

README badge

README badge for lexler/skill-factory/refactoring-team