Skip to content

feat(skills): add simplify-code skill — parallel 3-agent code review & cleanup#41691

Merged
teknium1 merged 1 commit into
mainfrom
hermes/hermes-208e5858
Jun 8, 2026
Merged

feat(skills): add simplify-code skill — parallel 3-agent code review & cleanup#41691
teknium1 merged 1 commit into
mainfrom
hermes/hermes-208e5858

Conversation

@teknium1

@teknium1 teknium1 commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a bundled simplify skill: review your recent code changes with three focused reviewers running in parallel, then aggregate and apply the worthwhile fixes. Inspired by Claude Code's /simplify (Boris Cherny, Feb 2026), adapted to Hermes tooling.

Zero core changes — the skill orchestrates existing tools (terminal/git, search_files, delegate_task batch mode).

How it works

  • Phase 1 — capture diff: git diff (working tree → staged → scoped variants for "last commit" / "this branch" / specific files).
  • Phase 2 — three reviewers in parallel via delegate_task batch mode, each given the full diff + repo path:
    • Reuse — duplicates of existing utilities/helpers
    • Quality — redundant state, parameter sprawl, copy-paste-with-variation, leaky abstractions, stringly-typed code
    • Efficiency — redundant work, missed concurrency, hot-path bloat, TOCTOU, memory leaks, overly broad reads
  • Phase 3 — aggregate, resolve conflicts, apply. Dedupes, discards false positives, resolves reviewer disagreements (correctness > user focus > readability/reuse > micro-perf), applies fixes, runs targeted tests, summarizes.

Adaptations from the original

Claude Code Hermes
3 hardcoded sub-agents delegate_task batch (3 is recommended fan-out, not a system cap)
Grep search_files
always applies fixes adds dry-run mode (answers the issue's open question)
focus modifier (reuse/quality/efficiency), scoped-diff modifiers
explicit conflict-resolution order; large-diff cost guard

Open questions from #379 resolved with defensible defaults: invoke-only (no auto-run), dry-run supported, conflict resolution order specified, folds in AGENTS.md/HERMES.md project conventions when present.

Changes

  • skills/software-development/simplify/SKILL.md — the skill
  • website/docs/.../software-development-simplify.md + skills-catalog.md + sidebars.ts — regenerated via website/scripts/generate-skill-docs.py

Validation

  • Real skill loader (iter_skill_index_files + parse_frontmatter + skill_matches_platform) discovers simplify, frontmatter parses, platform match OK, body has all 3 reviewers + batch instruction.
  • Description 48 chars (≤60), related_skills all resolve in the repo tree, zero dangling skill_view( calls.
  • tests/website/test_generate_skill_docs.py — 7/7 pass.

Closes #379.

Infographic

simplify skill infographic

…and cleanup

Inspired by Claude Code's /simplify. A bundled skill that captures recent
changes via git diff, fans out three focused reviewers (reuse, quality,
efficiency) via delegate_task batch mode, then aggregates findings and
applies the fixes worth applying.

Zero core changes — orchestrates existing tools (terminal/git, search_files,
delegate_task). Supports focus, dry-run, and scoped-diff modifiers.

Closes #379.
@teknium1 teknium1 force-pushed the hermes/hermes-208e5858 branch from 6aafc82 to d05769a Compare June 8, 2026 02:37
@teknium1 teknium1 changed the title feat(skills): add simplify skill — parallel 3-agent code review & cleanup feat(skills): add simplify-code skill — parallel 3-agent code review & cleanup Jun 8, 2026
@teknium1 teknium1 merged commit ace4b72 into main Jun 8, 2026
18 checks passed
@teknium1 teknium1 deleted the hermes/hermes-208e5858 branch June 8, 2026 05:02
changman pushed a commit to changman/hermes-agent that referenced this pull request Jun 10, 2026
…and cleanup (NousResearch#41691)

Inspired by Claude Code's /simplify. A bundled skill that captures recent
changes via git diff, fans out three focused reviewers (reuse, quality,
efficiency) via delegate_task batch mode, then aggregates findings and
applies the fixes worth applying.

Zero core changes — orchestrates existing tools (terminal/git, search_files,
delegate_task). Supports focus, dry-run, and scoped-diff modifiers.

Closes NousResearch#379.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Feature: Simplify Skill — Parallel Code Review & Cleanup (inspired by Claude Code /simplify)

1 participant