Content
60%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The office-hours workflow itself is exceptionally actionable and well-sequenced, with verbatim scripts, templates, and genuine feedback loops. But it is buried in ~350 lines of framework boilerplate and delivered as a 1090-line monolith with no reference files, and a dangling 'Phase 3.5' reference creates a real gap in the workflow. The skill would score dramatically higher with aggressive extraction into reference files.
Suggestions
Move the gstack framework boilerplate (preamble, Voice, AskUserQuestion Format, Completeness Principle, Telemetry, Plan Status Footer) into a shared framework file or the preamble binary; SKILL.md should begin at '# YC Office Hours' and be a fraction of its current size.
Extract the design doc templates and the three-tier 'Garry's Personal Plea' closing scripts into reference files (e.g., references/templates.md and references/closing.md), keeping SKILL.md as a concise overview with one-level-deep, clearly signaled references.
Define or remove 'Phase 3.5' — it is referenced in Phase 4 and in both design doc templates ('Cross-Model Perspective... if second opinion ran in Phase 3.5') but no Phase 3.5 section exists, so an agent cannot know when or how to run the second opinion.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~1090 lines, and roughly the first 350 lines (preamble telemetry bash, Voice persona, AskUserQuestion Format, Completeness Principle, Repo Ownership, Contributor Mode, Completion Status Protocol, Telemetry, Plan Status Footer) are framework boilerplate unrelated to office hours before the actual skill begins at '# YC Office Hours'. Several padded sections and unnecessary explanations put this at anchor 2; it avoids a 1 only because the core office-hours content itself is dense and mostly earns its place rather than explaining concepts Claude already knows. | 2 / 5 |
Actionability | Guidance is fully executable throughout: exact bash commands (slug eval, design lineage check, spec-review metrics append), verbatim AskUserQuestion scripts, BAD/GOOD pushback pattern examples for every question, and complete copy-paste-ready design doc templates for both modes. This matches anchor 5 — concrete commands and specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | The phase sequence (1 → 2A/2B → 2.5 → 2.75 → 3 → 4 → 4.5 → 5 → 6) is clear with explicit checkpoints: STOP after each question, premise agreement gates, approval loop (Approve/Revise/Start over), and a spec review loop with max iterations and a convergence guard. It falls short of 5 because 'Phase 3.5 (Codex or Claude subagent)' is referenced in Phase 4 and both design doc templates but never defined anywhere in the document, leaving the second-opinion step undefined, and the Visual Design Exploration section floats unnumbered between phases. | 4 / 5 |
Progressive Disclosure | This is a monolithic single-file skill: no references/, scripts/, or assets/ directories exist in the bundle, and ~1090 lines are inlined in SKILL.md — including design doc templates, the three-tier closing plea scripts, and the framework boilerplate, all of which clearly belong in separate reference files. The only external pointers (ETHOS.md, other gstack skills) live outside the bundle. This matches anchor 2 ('content that clearly belongs in separate files is inlined') rather than 3, since there is effectively no progressive disclosure structure at all, only in-file headers. | 2 / 5 |
Total | 13 / 20 Passed |