Agent Skills collection and software-delivery orchestration playbooks · Personal library with substantial reported interest, but maturity is uncertain because supplied metadata is future-dated and validation infrastructure was not provided.

dzhng/skills

MIT-licensed collection of 22 README-enumerated Agent Skills for Claude Code and other skill-compatible coding harnesses, centered on an autonomous software-factory loop that explores unknowns, writes and implements living specs, reviews each slice, records agent-made choices, validates visuals, and closes shipped specs into rationale records.

software engineeringrequirements discoverytechnical specificationagent orchestrationcode qualitytestingperformancedocumentationvisual QAWebGPU renderingskill authoringmarketing websites
Routing score
80.0
Readiness
Usable selectively with caveats; the multi-day autonomous workflow requires capable host tooling, project-specific verification, and human review.
License
MIT
Maintenance
active
Components
20
Revision
0

Selection

Select when

  • You want a reusable Claude Code skill library rather than a new coding-agent host.
  • A large feature should be decomposed into independently buildable and verifiable slices.
  • The implementation plan must evolve when new facts emerge during coding.
  • You want agent-made architectural and product choices recorded for later review.
  • You need a structured cleanup, code-review, and documentation closeout pass.
  • You want screenshot comparison and independent visual critique integrated into delivery.
  • You work on WebGPU, three.js, TSL, or WGSL rendering and need detailed validation rules.
  • You want to author or blind-evaluate additional Agent Skills.
  • You explicitly want Claude Code or Codex used as a separately verified second agent.
  • You prefer selective installation of small, editable Markdown skills.

Boundaries

Avoid when

  • You need a fully autonomous result without human acceptance criteria or final review.
  • You require every listed skill to be bundled by the supplied Claude plugin manifest.
  • You cannot permit skills or agents to inspect and potentially modify a working tree.
  • You lack the external Claude Code or Codex CLI required by their respective delegation skills.
  • You require platform-independent GUI image review rather than the macOS Preview workflow.
  • You need a proven security audit, compatibility matrix, or independently benchmarked reliability.
  • You need a standalone application, MCP server, or hosted orchestration service.
  • You cannot isolate broad-permission agent runs in dedicated worktrees.
  • You need guaranteed multi-agent compatibility beyond repository claims.
  • You require stable performance evidence without project-specific hardware and browser verification.

Strengths

Capabilities

The README enumerates 22 skills across engineering, visual review, authoring, and graphics.Skills use SKILL.md frontmatter and procedural Markdown intended for on-demand context loading.The documented skills CLI can add the collection or support selecting individual skills.Users can alternatively copy individual skill folders into a harness skills directory such as .claude/skills.A Claude plugin manifest packages 12 named skills as one plugin.The explore-unknowns workflow is described as mapping knowns, questions, reactable artifacts, and blind spots.The write-spec workflow decomposes large features into independently verifiable and human-reviewable slices.The implement-spec workflow builds slices iteratively and can delegate independent work in parallel.The full-loop design treats specifications as living plans that can be re-sliced when implementation changes understanding.The audit-choices workflow reviews an implementer's decision ledger instead of requiring a full diff review.The review workflow sequences structural cleanup, diff review, and documentation into one closeout verdict.Engineering skills cover refactoring, behavior-focused testing, performance auditing, documentation, and code review.The ELI5 skill produces standalone problem, solution, and schema-change explanations.The Codex skill supports verified second-opinion reviews and explicitly requested implementation delegation through the local Codex CLI.The Claude skill supports consultation or explicitly requested delegation through a local authenticated Claude Code CLI.Visual workflows compare screenshots, request unprimed critique, and curate image sets for manual review.The preview-shots skill opens selected saved images in a single macOS Preview window.Authoring workflows define skill structure, progressive disclosure, trigger design, failure modes, blind evaluation, and revision loops.The renderer skill provides extensive WebGPU, three.js, TSL, WGSL, depth, pass, performance, and browser-validation guidance.A marketing-pages skill is listed for crawl, canonical-copy, indexing, linking, and call-to-action rules by page class.

Risk profile

Risks and limitations

  • Uncertainty: only selected first-party files were supplied, so many of the 22 listed skills, any helper scripts, assets, package configuration, tests, CI workflows, and marketplace metadata were not inspected.
  • Uncertainty: repository creation and activity dates are in 2026 relative to the analysis context, so recency, adoption, and maturity signals cannot be independently reconciled.
  • Uncertainty: the README claims compatibility with more than 70 harnesses, but no host matrix or cross-host test evidence was supplied.
  • The Claude plugin manifest names only 12 skills, while the README enumerates 22, so plugin installation may not expose the full advertised collection.
  • The full loop invokes a /goal capability that is not present in the supplied skill inventory or plugin manifest, suggesting an external harness dependency that is not fully documented here.
  • The cited 1-day-16-hour unattended Codex run is repository-reported proof from one run and does not establish repeatable correctness or general reliability.
  • No minimum Claude Code version, plugin update behavior, automated compatibility results, security policy, threat model, telemetry disclosure, or independent audit was supplied.
  • Several workflows rely on external CLIs, authenticated network services, browsers, GPU hardware, project tests, or other environment-specific tools.
  • The Codex and Claude delegation guidance includes broad-permission modes for some tasks; even with documented isolation controls, these modes materially increase local execution risk.
  • Visual verification depends on saved artifacts and human judgment, while preview-shots is specifically limited to macOS Preview.
  • Multi-hour or multi-day autonomous runs can consume substantial model budget and still require several hours of human work at the beginning and end according to the README.
  • The renderer skill contains detailed, potentially version-sensitive claims about three.js, TSL, Playwright, Chromium, and GPU behavior that were not independently tested.

The skills operate inside development workspaces and can direct shell commands, local authenticated agent CLIs, browsers, and file edits. The Codex and Claude files describe broad-permission execution only for explicit delegation and pair it with dedicated-worktree isolation and mandatory diff review, but these are procedural controls rather than a sandbox guarantee. No security audit or threat model was supplied.

Component inventory

20 documented components

Claude Code plugin and cross-harness skill library

skills

Domain-agnostic software-factory skills; native plugin manifest exposes 12 skills, while the README catalogs the wider library.

.claude-plugin/plugin.json; README.md
skill

explore-unknowns

Maps a task’s knowns and unknowns through interviews, artifacts, options, and blind-spot passes.

skills/engineering/explore-unknowns/SKILL.md
skill

write-spec

Slices a feature into independently buildable, verifiable, human-reviewable checkpoints.

skills/engineering/write-spec/SKILL.md
skills and workflow

implement-spec and implement-spec-with-codex

Builds a spec iteratively; the Codex variant delegates coding while the parent orchestrates and reviews.

skills/engineering/implement-spec/SKILL.md; skills/engineering/implement-spec-with-codex/SKILL.md
skill

close-spec

Archives a shipped spec and rewrites it as an audited rationale, invariant, and code-pointer record.

skills/engineering/close-spec/SKILL.md
skill

refactor-clean

Refactors toward one clean owner or concept instead of adding compatibility sediment.

skills/engineering/refactor-clean/SKILL.md
skill

write-tests

Writes tracer-bullet tests that pin real behavior rather than implementation details or lucky samples.

skills/engineering/write-tests/SKILL.md
skill

audit-performance

Finds amplifying or non-progressing hot paths and recommends the smallest bounded fix.

skills/engineering/audit-performance/SKILL.md
skill

write-docs

Writes principle-and-pointer documentation without duplicating code-owned inventories or history.

skills/engineering/write-docs/SKILL.md
skill

code-review

Audits a diff for stale names, dead references, complexity, and narrating comments, then gives a verdict.

skills/engineering/code-review/SKILL.md
skill

audit-choices

Reviews the implementer’s decision ledger rather than the diff, surfacing architecture and uncertain choices.

skills/engineering/audit-choices/SKILL.md
user-invoked skill

eli5

Explains a spec or change in standalone plain language, including exhaustive durable-contract changes.

skills/engineering/eli5/SKILL.md
orchestration skill

review

Runs refactor-clean, code-review, and write-docs in order, looping until one closeout verdict is clean.

skills/engineering/review/SKILL.md
second-agent skills

codex and claude

Use local Codex CLI or Claude Code as independently verified reviewers or explicitly requested implementers.

skills/engineering/codex/SKILL.md; skills/engineering/claude/SKILL.md
skill

marketing-pages

Creates and audits marketing pages with page-class rules for indexing, linking, CTAs, sitemaps, and canonical copy.

skills/engineering/marketing-pages/SKILL.md
visual-review skill

compare-screenshots

Measures and compares captures to locate divergence and detect flat, empty, or misframed output.

skills/visual/compare-screenshots/SKILL.md
visual-review skill

screenshot-critique

Uses an unprimed subagent as a second set of eyes before visual work is accepted.

skills/visual/screenshot-critique/SKILL.md
macOS visual-review skill

preview-shots

Curates and opens review images together in one macOS Preview window, with cleanup rules.

skills/visual/preview-shots/SKILL.md
skill-authoring skills

write-skills and eval-skills

Creates concise operational skills, then evaluates them blindly against golden cases with separate judges.

skills/authoring/write-skills/SKILL.md; skills/authoring/eval-skills/SKILL.md
graphics engineering skill

renderer

Builds, debugs, and reviews WebGPU, three.js/TSL, and WGSL renderers with browser, visual, and GPU validation.

skills/graphics/renderer/SKILL.md

Technical profile

Requirements and configuration

Repository
dzhng/skills
License
MIT
Primary Language
JavaScript according to GitHub metadata, while inspected skill entry points are Markdown.
Default Branch
main
Repository Size
5,533 KB according to supplied GitHub metadata.
Github Signals
800 stars, 55 forks, 4 subscribers, and 3 open issues in the supplied metadata; timing is uncertain because dates are future-dated.
Skill Inventory
The README enumerates 22 skills: 16 engineering, 3 visual, 2 authoring, and 1 graphics.
Claude Plugin
The .claude-plugin/plugin.json manifest defines a plugin named skills containing 12 skill directories.
Skill Format
Each inspected skill uses YAML frontmatter followed by Markdown workflows, rules, and completion criteria.
Documented Installation
The README documents a skills CLI for full or selective addition and manual copying into a harness skills directory.
Host Paths
The README gives .claude/skills as the Claude Code example directory.
External Agents
Dedicated skills invoke local Claude Code through claude -p and Codex through codex review or codex exec.
Platform Constraints
preview-shots uses macOS Preview and AppleScript; renderer validation expects browser and WebGPU-related tooling.
Repository Status
Public, non-fork, non-archived, and enabled according to supplied metadata.

Classification

How it enters the stack

Context InjectionOrchestrationSkill Authoring

Evidence: SKILL.md packages can be copied into .claude/skills, and a Claude plugin manifest bundles 12 skills. Review, implementation, and full-loop skills coordinate other skills or agents; write-skills and eval-skills define authoring and evaluation methods. Basic installation is short, although advanced workflows need external tools.

Claude Extension · low setup effort · high confidence · automated

Evidence and risk

Primary sources

first_party_fileREADME.mdhttps://github.com/dzhng/skills/blob/main/README.md

Routing context

Conflicts, complements, and synergies

overlaps_with

gh_amelnagdy_delegate_skills

Both are Agent Skill collections that can delegate implementation to separate Claude or Codex CLIs, but delegate-skills specializes in a normalized multi-CLI relay and fleet workflow.

medium confidence
same_owner

gh_dzhng_deep_research

Both repositories are owned by dzhng; the supplied files do not document technical integration between them.

high confidence
similar_to

gh_mattpocock_skills

Inference: both are composable engineering-skill collections covering specifications, implementation, testing, debugging or refactoring, research or discovery, and review; dzhng/skills adds a stronger autonomous factory loop, choices ledger, visual QA, and renderer specialization.

high confidence
ecosystem_peer

gh_anthropics_skills

Inference: both provide reusable Agent Skills consumable by Claude Code and include skill-authoring material, but the supplied evidence does not establish derivation or direct dependency.

medium confidence
alternative_to

gh_orchestra_research_ai_research_skills

Inference: both install composable skills and orchestrate multi-stage work, but this repository targets general software delivery and visual verification while Orchestra-Research focuses on AI research and engineering.

medium confidence
similar_to

gh_google_mantis

Catalog inference: both provide portable SKILL.md workflows and multi-stage software-agent orchestration, while Mantis is specialized for defensive security campaigns.

medium confidence
overlaps

gh_nateherkai_scroll_craft

Both package Claude-compatible skills with frontend and visual-review concerns, while scroll-craft is narrower and adds a dedicated scroll engine and verification harness.

medium confidence
complements

gh_orron_epicinfographics

Both emphasize iterative visual review and skill-based graphics guidance; Epic Infographics adds a dedicated infographic preflight and render pipeline.

medium confidence
complements

gh_referodesign_refero_skill

Refero supplies research locks and design evidence, while dzhng/skills includes broader implementation loops and screenshot-oriented visual review workflows.

medium confidence