Agent skill

Validation Report Generator

by alirezarezvani in alirezarezvani/claude-cto-team

Generate structured 8-section validation reports with verdict (GOOD/BAD/NEEDS MAJOR WORK), strengths, critical flaws, blindspots, and concrete path forward.

MITAuto-check passed

Install Validation Report Generator

skills CLI
$ npx skills add alirezarezvani/claude-cto-team --skill validation-report-generator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-cto-team validation-report-generator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-cto-team.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/validation-report-generator .claude/skills/validation-report-generator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
validation-report-generator
GitHub stars
117
Token cost
~1.8k tokens
SKILL.md length
644 words
Files
3
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Generate structured 8-section validation reports with verdict (GOOD/BAD/NEEDS MAJOR WORK), strengths, critical flaws, blindspots, and concrete path forward.

  • Works in 5 steps: Gather Analysis → Determine Verdict → Gather Evidence → …
  • SKILL.md covers When to Use, Report Structure, Generating the Report and Output Format, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Validation Report Generator is an agent skill from alirezarezvani/claude-cto-team. Generate structured 8-section validation reports with verdict (GOOD/BAD/NEEDS MAJOR WORK), strengths, critical flaws, blindspots, and concrete path forward. Use after strategic-cto-mentor has completed validation analysis and needs to produce final deliverable.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `report-template.md` and `verdict-criteria.md`).

The repository describes itself as: Your personal CTO Team for Claude Code . These Subagents will help you challenging yourself while you plan and execute. The licence is MIT.

Example prompts

  • “/validation-report-generator”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Gather Analysis
  2. Determine Verdict
  3. Gather Evidence
  4. Calibrate Tone
  5. Write Report

What it can do on your machine

Read from SKILL.md and the folder at commit a5bbb78. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Validation Report Generator loads about 1.8k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 644 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alirezarezvani/claude-cto-team at commit a5bbb78, republished under its MIT licence (© alirezarezvani). 644 words, ~1,768 tokens.

Download SKILL.mdSave it as .claude/skills/validation-report-generator/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
validation-report-generator
description
Generate structured 8-section validation reports with verdict (GOOD/BAD/NEEDS MAJOR WORK), strengths, critical flaws, blindspots, and concrete path forward. Use after strategic-cto-mentor has completed validation analysis and needs to produce final deliverable.

Validation Report Generator

Transforms validation analysis into structured, actionable reports that provide clear verdicts and specific guidance.

When to Use

  • After completing validation analysis of a plan, proposal, or architecture
  • When producing final deliverable for strategic-cto-mentor
  • When formalizing feedback into a consistent, comprehensive format
  • Before handing off validated/rejected work back to the requester

Report Structure

Every validation report follows the 8-Section Format:

Section 1: Verdict

Purpose: Unambiguous assessment with confidence level

Options:

  • GOOD: Ready for implementation (may have minor suggestions)
  • NEEDS MAJOR WORK: Fundamentally sound but has significant gaps
  • BAD: Should not proceed without fundamental rethinking

Include:

  • Clear verdict (one of the three options)
  • Confidence level (High/Medium/Low)
  • One-sentence summary of why
Section 2: What You Got Right

Purpose: Acknowledge genuine strengths (builds trust for criticism)

Include:

  • 2-3 specific things done well
  • Why each matters
  • What to preserve in revisions

Avoid:

  • Generic praise ("good work!")
  • Inflating minor positives
  • Praising the obvious
Section 3: Critical Flaws

Purpose: Expose fatal or near-fatal weaknesses

Format for each flaw:

**Flaw**: [What's wrong]
**Why It Matters**: [Business/technical impact]
**Consequence**: [What happens if not addressed]

Include:

  • Prioritized list (most critical first)
  • Specific evidence, not vague concerns
  • Impact quantification where possible
Section 4: What You're Not Considering

Purpose: Surface blindspots and hidden assumptions

Types of blindspots:

  • Unstated assumptions (treated as facts)
  • Ignored failure modes
  • Missing stakeholders
  • External dependencies not accounted for
  • Scale implications not considered

Include:

  • What was assumed vs. what should be validated
  • Questions that should have been asked
  • Scenarios that weren't explored
Section 5: The Real Question

Purpose: Reframe if solving wrong problem

When to use:

  • Problem definition is too narrow/broad
  • Symptoms treated instead of root cause
  • Constraint accepted that should be challenged
  • Solution in search of a problem

Format:

"You're asking [stated question], but the real question might be [reframed question]."

Skip if: The problem is correctly framed (state this explicitly)

Section 6: What Bulletproof Looks Like

Purpose: Define success criteria for revision

Include:

  • Specific criteria for acceptable solution
  • Measurable outcomes
  • What evidence would prove the concerns addressed

Format:

For this to be ready for implementation:
- [ ] [Criterion 1]
- [ ] [Criterion 2]
- [ ] [Criterion 3]

Purpose: Concrete next steps

If GOOD:

  • Any minor improvements before proceeding
  • What to monitor during implementation
  • Validation checkpoints

If NEEDS MAJOR WORK:

  • Specific areas to revise
  • Suggested approach for each
  • Whether to route back to architect

If BAD:

  • Alternative approaches to consider
  • What fundamental rethinking is needed
  • Whether to restart with different framing
Show full SKILL.md (266 more words)Show less
Section 8: Questions You Need to Answer First

Purpose: Information gaps blocking progress

Include:

  • Questions that must be answered before proceeding
  • Who can answer each question
  • What decisions are blocked until answered

Generating the Report

Step 1: Gather Analysis

Before generating report, ensure you have completed:

  • Assumption identification
  • Risk assessment (7 dimensions)
  • Anti-pattern detection
  • Timeline/budget reality check
  • Team capacity evaluation
Step 2: Determine Verdict

Use the Verdict Criteria to classify:

GOOD if:

  • Core assumptions are valid
  • Timeline is realistic
  • Budget is appropriate
  • Team can execute
  • Risks are manageable
  • No fundamental anti-patterns

NEEDS MAJOR WORK if:

  • Core approach is sound but...
  • Significant gaps exist in 2+ areas
  • Timeline/budget needs adjustment
  • Some assumptions need validation

BAD if:

  • Core assumptions are invalid
  • Fundamental anti-pattern detected
  • Timeline is fantasy
  • Budget is unrealistic by >50%
  • Team cannot execute
  • Wrong problem being solved
Step 3: Gather Evidence

For each section, cite specific evidence:

  • Quote from the proposal
  • Data points that contradict claims
  • Industry benchmarks
  • Historical precedent
Step 4: Calibrate Tone

Match tone to verdict:

VerdictTone
GOODAffirming with minor suggestions
NEEDS MAJOR WORKConstructive but direct
BADBrutally honest but respectful
Step 5: Write Report

Use the Report Template to structure output.


Output Format

markdown
# Validation Report: [Title]

**Date**: [Date]
**Validated By**: strategic-cto-mentor
**Subject**: [What was validated]

---

## 1. Verdict

### VERDICT: [GOOD / NEEDS MAJOR WORK / BAD]
**Confidence**: [High / Medium / Low]

[One-sentence summary of why this verdict]

---

## 2. What You Got Right

[2-3 specific strengths with explanation of why they matter]

---

## 3. Critical Flaws

### Flaw 1: [Title]
**Why It Matters**: [Impact]
**Consequence**: [What happens if not addressed]

### Flaw 2: [Title]
...

---

## 4. What You're Not Considering

[Blindspots, hidden assumptions, ignored scenarios]

---

## 5. The Real Question

[Reframe if needed, or state "Problem is correctly framed"]

---

## 6. What Bulletproof Looks Like

For this to be ready for implementation:
- [ ] [Criterion 1]
- [ ] [Criterion 2]
- [ ] [Criterion 3]

---

## 7. Recommended Path Forward

[Specific next steps based on verdict]

---

## 8. Questions You Need to Answer First

| Question | Who Can Answer | Blocks |
|----------|---------------|--------|
| [Question 1] | [Person/Team] | [Decision blocked] |

---

*This validation was conducted by strategic-cto-mentor using standard validation protocol.*

Quality Checklist

Before delivering report, verify:

  • Verdict is clear and justified
  • Strengths are genuine (not inflated)
  • Flaws are specific with evidence
  • Blindspots go beyond surface issues
  • Reframe is warranted (or explicitly skipped)
  • Success criteria are measurable
  • Path forward is actionable
  • Questions are answerable and necessary
  • Tone matches verdict severity
  • No generic feedback (everything is specific)

References

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in skills/validation-report-generator of alirezarezvani/claude-cto-team.

  • SKILL.md
  • report-template.md
  • verdict-criteria.md

Open the folder on GitHubat commit a5bbb78

Compare with similar skills

Validation Report Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Validation Report Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Validation Report Generator this skillalirezarezvani/claude-cto-team117—~1.8kAutomated safety check: PassMIT
Generatealirezarezvani/claude-skills28k1 repos~1.1kAutomated safety check: PassMIT
Fal Generatenexu-io/open-design100k—~306Automated safety check: PassApache-2.0
Video Generationbytedance/deer-flow83k4 repos~1.4kAutomated safety check: PassMIT
Image Generationonyx-dot-app/onyx32k1 repos~1.7kAutomated safety check: PassCustom licence
Structured Image Generationbytedance/deer-flow83k5 repos~2.9kAutomated safety check: PassMIT

Similar skills

  • Generate

    alirezarezvani/claude-skills

    Generate Playwright tests. An agent skill from alirezarezvani/claude-skills.

    28k GitHub starsUsed in 1 repo~1.1k tokens
    Testing & QAAuto-check passed
  • Fal Generate

    nexu-io/open-design

    Generate images and videos using fal.ai AI models. An agent skill from nexu-io/open-design.

    100k GitHub stars~306 tokensUpdated today
    Media & CreativeAuto-check passed
  • Video Generation

    bytedance/deer-flow

    Generates short videos from a structured JSON prompt, optionally guided by a reference image used as the first or last frame.

    83k GitHub starsUsed in 4 repos~1.4k tokens
    Media & CreativeAuto-check passed
  • Image Generation

    onyx-dot-app/onyx

    Generate or edit raster images (photos, illustrations, textures, sprites, mockups, logos, infographics) using the workspace's configured image-generation provider via onyx-cli image.

    32k GitHub starsUsed in 1 repo~1.7k tokens
    Media & CreativeAuto-check passed
  • Structured Image Generation

    bytedance/deer-flow

    Turns an image request into a structured JSON prompt and runs a bundled Python script to generate the picture, optionally guided by reference images.

    83k GitHub starsUsed in 5 repos~2.9k tokens
    Media & CreativeAuto-check passed
  • Generate Nanobanana

    sickn33/agentic-awesome-skills

    Generate and edit images/video with Google's Gemini media models (Nano Banana 2/Pro, Gemini Omni Flash), with cost-approval gates, reference-image support, and a prompt/output log per call.

    47k GitHub starsUsed in 1 repo~2.8k tokens
    Media & CreativeAuto-check: notes

More from alirezarezvani/claude-cto-team

All 12 skills in this repo
  • Antipattern Detector

    alirezarezvani/claude-cto-team

    Detect common technical and organizational anti-patterns in proposals, architectures, and plans.

    117 GitHub stars~2.1k tokensUpdated 9 mo ago
    Auto-check passed
  • Architecture Pattern Selector

    alirezarezvani/claude-cto-team

    Recommend architecture patterns (monolith, microservices, serverless, modular monolith) based on scale, team size, and constraints.

    117 GitHub stars~1.6k tokensUpdated 9 mo ago
    Auto-check passed
  • Assumption Challenger

    alirezarezvani/claude-cto-team

    Identify and challenge implicit assumptions in plans, proposals, and technical decisions.

    117 GitHub stars~2.4k tokensUpdated 9 mo ago
    Auto-check passed
  • Cost Estimator

    alirezarezvani/claude-cto-team

    Infrastructure and development cost estimation for technical projects.

    117 GitHub stars~3k tokensUpdated 9 mo ago
    Auto-check passed
  • ML Cv Specialist

    alirezarezvani/claude-cto-team

    Deep expertise in ML/CV model selection, training pipelines, and inference architecture.

    117 GitHub stars~3.1k tokensUpdated 9 mo ago
    Auto-check passed
  • Request Analyzer

    alirezarezvani/claude-cto-team

    Analyze incoming user requests to detect intent, request type (design/validate/debug/document), complexity level, and identify vague requirements or buzzwords that need clarification.

    117 GitHub stars~1.3k tokensUpdated 9 mo ago
    Auto-check passed

Questions about Validation Report Generator

What does Validation Report Generator do?

Generate structured 8-section validation reports with verdict (GOOD/BAD/NEEDS MAJOR WORK), strengths, critical flaws, blindspots, and concrete path forward. Validation Report Generator is an agent skill from alirezarezvani/claude-cto-team. Generate structured 8-section validation reports with verdict (GOOD/BAD/NEEDS MAJOR WORK), strengths, critical flaws, blindspots, and concrete path forward.

How do I install Validation Report Generator in Claude Code?

Run `npx skills add alirezarezvani/claude-cto-team --skill validation-report-generator -a claude-code`. Or copy the skill folder (skills/validation-report-generator in alirezarezvani/claude-cto-team) into .claude/skills/validation-report-generator in your project. Claude Code loads it when a task matches its description.

How do I install Validation Report Generator in Codex?

Run `npx skills add alirezarezvani/claude-cto-team --skill validation-report-generator -a codex`. Or copy the skill folder (skills/validation-report-generator in alirezarezvani/claude-cto-team) into .agents/skills/validation-report-generator in your project. Codex loads it when a task matches its description.

Can I use Validation Report Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-cto-team --skill validation-report-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/validation-report-generator, .gemini/skills/validation-report-generator, .github/skills/validation-report-generator and .opencode/skills/validation-report-generator in your project.

What does Validation Report Generator need to run?

SKILL.md names no scripts, command-line tools or credentials: Validation Report Generator is instructions for the agent only.

Does Validation Report Generator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Validation Report Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Validation Report Generator use?

Validation Report Generator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Validation Report Generator use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Validation Report Generator?

Skills that share tags, products or a category with Validation Report Generator: Generate (alirezarezvani/claude-skills, 28k stars), Fal Generate (nexu-io/open-design, 100k stars), Video Generation (bytedance/deer-flow, 83k stars) and Image Generation (onyx-dot-app/onyx, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Validation Report Generator?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-cto-team, which has 117 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on December 18, 2025.

Source: alirezarezvani/claude-cto-team on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.