One-click install
npx skills add https://github.com/joshka0/foxctl --skill foxctl-epic-grader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foxctl-epic-grader
Source: https://github.com/joshka0/foxctl/tree/main/configs/skills-pack/foxctl-epic-grader
Command: npx skills add https://github.com/joshka0/foxctl --skill foxctl-epic-grader

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

foxctl-epic-grader turns an epic’s planning quality into a strict, rubric-based readiness decision, so teams can stop implementation before structural planning gaps cause churn or misaligned execution.

Core Features & Use Cases

  • Rubric-based epic creation grading: Enforces a 100-point total and strict deductions tied to observable planning weaknesses.
  • Planning-only evaluation: Prevents reward for implementation progress and focuses on execution suitability of the epic as a plan.
  • Import-vs-source aware scoring: Compares Factory-imported epics against mission/contracts/artifacts, and grades authored epics against their intake source when available.
  • Operator-ready report output: Produces a compact report with decision (READY|NOT READY), category scores, blockers, upgrade actions, and nuance notes.

Quick Start

Use foxctl-epic-grader to grade an epic planning artifact by running it with the room and epic identifiers you want evaluated, ensuring it reads the epic structure and relevant reference artifacts for scoring.

Frequently Asked Questions about foxctl-epic-grader

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

FAQPage Schema
How do I score epic readiness before starting implementation?

Epic readiness scoring evaluates an epic's planning quality against a strict 100-point rubric to output a READY or NOT READY decision, preventing structural planning gaps from causing execution churn.

What is requirements traceability in epic grading?

Requirements traceability in epic grading inspects milestone, story, validator, and intake surfaces to ensure the epic plan aligns with source artifacts before implementation begins.

How do I grade Factory-imported epics against source contracts?

Grading Factory-imported epics compares the epic against mission, contracts, and related artifacts, while authored epics are graded against their intake source to evaluate planning suitability.

Does epic grading evaluate implementation progress or planning quality?

Epic grading evaluates planning quality only, deliberately preventing reward for implementation progress to focus entirely on the execution suitability of the epic as a plan.

What does an epic readiness report include?

An epic readiness report includes a READY or NOT READY decision, category scores, blockers, upgrade actions, and nuance notes based on a strict 100-point rubric evaluation.

When should I not use automated epic grading?

Automated epic grading should not be used when you lack rubric references or related artifacts, as the scoring workflow requires inspecting these to enforce the 100-point total and produce valid decisions.