arjenschwarz/agentic-coding
Overview
This skill performs a parallel code audit by running two focused subagents—one that simplifies code and one that critiques design—and consolidates their findings into a prioritized report. It highlights shared concerns, architecture issues, and simplification opportunities, then offers to create actionable Transit tasks. Use it to get a quick, structured quality assessment of the current working directory.
How this skill works
The skill spawns two parallel subagents: a code-simplifier that scans for complexity hotspots and unnecessary abstractions, and a design-critic that inspects architecture, module boundaries, and data flow. Each subagent returns structured findings with location, summary, and severity. The skill deduplicates and groups findings into Simplification, Architecture, and Shared Concerns, sorts them by severity, and presents a clear report. Finally, it can convert selected findings into Transit tasks (chore or bug) for tracked remediation.
When to use it
- Before a major refactor to identify simplification targets and architecture risks
- During code review cycles to surface systemic issues beyond single PRs
- When onboarding to a new codebase to get a consolidated quality snapshot
- To prepare for production release by finding high-severity design or complexity problems
- When creating a prioritized backlog of technical debt and maintenance work
Best practices
- Run from the project root so both subagents inspect the full codebase
- Provide or reference any project conventions (coding standards, CLAUDE.md) to guide analysis
- Review Shared Concerns first — they represent the highest signal from both analyses
- Group related findings into a single Transit task when work spans multiple files or is a single change
- Prioritize high-severity items for immediate action and track medium/low as planned improvements
Example use cases
- Audit a legacy Python package to identify complexity hotspots and unsafe abstractions
- Assess a microservice repository to find architecture boundary violations and data flow risks
- Generate a prioritized todo list of refactors and bug fixes before a release
- Create tracked Transit tasks for technical debt items found across modules
- Combine simplification suggestions into a single chore to improve readability and reduce LOC
FAQ
The skill matches findings by location and concern, merging entries that point to the same file/issue to avoid duplicates.
What types of Transit tasks are created?
Simplification items become type 'chore' and design problems that could cause failures become type 'bug'. Tasks include the finding details and suggested actions.
17 skills
This skill performs a parallel code audit by coordinating code-simplifier and design-critic analyses to deliver a prioritized quality report.
This skill automates batch-fixing open bugs in parallel using git worktrees and subagents, speeding up transit bug resolution.
This skill explains code changes or designs at beginner, intermediate, and expert levels to improve understanding and reveal gaps.
This skill routes Transit tickets to the correct workflow by extracting the T-[number], fetching task details, and handing off to the appropriate handler.
This skill helps you automatically fetch and implement the next unfinished group of tasks using rune, manage subtasks, and report progress.
This skill generates a precise, test-driven task plan for implementing a feature by converting design into incremental coding tasks with clear dependencies.
This skill automates PR feedback processing by validating issues, generating fixes, and verifying CI status across code-level and PR-level comments.
This skill helps you ensure code quality before pushing by reviewing unpushed commits against specs, tests, and standards.
This skill initializes a feature spec workflow from idea to actionable tasks, guiding scope, requirements, design, and branch creation.
This skill generates an initial set of requirements in EARS format for a feature idea, then iterates with the user to refine them.
This skill creates a comprehensive feature design document from requirements, researching needs, and detailing architecture, data models, and testing strategy.
This skill analyzes session history to generate precise Claude Code permissions and helps merge them into settings.
This skill initializes a Claude Code project with standard hooks and language-specific permissions for seamless setup.
This skill evaluates and improves user interfaces across CLI, web, and mobile, delivering concrete, actionable UX enhancements that boost usability and
This skill analyzes recently added or modified Python code to identify performance improvements and efficiency gains.
This skill summarizes branch changes by identifying base branch, summarizing commits, listing changed files, and explaining rationale behind edits.
This skill creates a lightweight smolspec to rapidly plan small code changes, estimate scope, and outline tasks with clear success criteria.
