tech-talk-reportcard

Analyze a Swift codebase and generate an A-F tech-talk report card.

49|9|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/Terryc21/xcode-workflow-skills --skill tech-talk-reportcard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-talk-reportcard
Source: https://github.com/Terryc21/xcode-workflow-skills/tree/main/skills/tech-talk-reportcard
Command: npx skills add https://github.com/Terryc21/xcode-workflow-skills --skill tech-talk-reportcard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the production of a structured tech-talk report card for codebases, translating complex metrics into clear grades and prioritized actions.

Core Features & Use Cases

  • Project metrics extraction (files, LOC, architecture, tests)
  • Automated grading across categories: Architecture, Security, Performance, Concurrency, Accessibility, Code Quality, UI, Testing, and Data
  • Output a formatted report at .agents/research/YYYY-MM-DD-tech-reportcard.md with actionable recommendations
  • Trend comparison with previous reports when available
  • Optional deep-dive integration via Axiom for advanced analytics

Quick Start

Run the tech-talk-reportcard workflow on your repository to generate a full report with grades and recommended actions.

Frequently Asked Questions about tech-talk-reportcard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a tech-talk report card for my Swift codebase?

A tech-talk report card evaluates a Swift codebase by assigning A-F grades across architecture, security, performance, concurrency, accessibility, code quality, UI, testing, and tooling, while documenting risks, ROI, and blast radius for each finding.

What is a codebase report card and what metrics does it grade?

A codebase report card evaluates a Swift project by assigning A-F grades across architecture, security, performance, concurrency, accessibility, code quality, UI, testing, and tooling, while documenting risks, ROI, and blast radius for each finding.

How do I analyze Swift architecture and concurrency risks automatically?

The generated report is saved locally as a markdown file at .agents/research/YYYY-MM-DD-tech-reportcard.md, containing actionable recommendations, next steps for stakeholders, and trend comparisons with previous reports when available.

Where does the automated code review report get saved?

The automated code review report is saved locally as a markdown file at .agents/research/YYYY-MM-DD-tech-reportcard.md, containing actionable recommendations, next steps for stakeholders, and trend comparisons with previous reports when available.

Can I track Swift code quality trends over time?

You can track Swift code quality trends over time because the grading workflow compares current codebase metrics and grades against previous report cards when available, highlighting progress across architecture, security, and performance categories.

Does the report card support deep-dive analytics for performance findings?

The report card supports optional deep-dive analytics integration via Axiom for advanced performance evaluation, building on the baseline project metrics, architecture pattern analysis, and state management documentation extracted during the standard workflow.