assessment-report

Generate structured assessment reports from scoring, question, and issue data.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/opensourceways/geo-workflow --skill assessment-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: assessment-report
Source: https://github.com/opensourceways/geo-workflow/tree/main/.claude/skills/assessment-report
Command: npx skills add https://github.com/opensourceways/geo-workflow --skill assessment-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This skill automates the generation of structured assessment reports for platform-citation analysis, consolidating scoring results, questions, and issue data into machine-readable JSON and human-readable Markdown.

Core Features & Use Cases

  • Merge scoring results with questions and issue maps into per-question records.
  • Produce category-grouped summaries and trend insights for historical comparison.
  • Output both assessment-report.json and assessment-report.md for downstream tooling and reporting.

Quick Start

Run the skill against your scoring-results.json, questions.json, and issue-map.json to generate the reports.

Frequently Asked Questions about assessment-report

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

FAQPage Schema
How do I generate a markdown assessment report from JSON scoring results?

To generate a markdown assessment report from JSON scoring results, you merge scoring-results.json, questions.json, and issue-map.json to produce human-readable assessment-report.md and machine-readable assessment-report.json files.

What is platform-citation analysis in GEO workflows?

Platform-citation analysis in GEO workflows evaluates issue data and scoring results to consolidate per-question records and category-grouped summaries for structured assessment reporting.

Do I need Python 3.8 or higher to run GEO trend analysis and reporting?

Yes, you need Python 3.8 or higher to run GEO trend analysis and reporting, as the process requires this environment to parse JSON inputs and output the assessment report files.

Can I compare historical GEO assessment trends across previous runs?

Yes, you can compare historical GEO assessment trends across previous runs because the reporting process generates trend insights by comparing current scoring results against historical data.

What is the best way to consolidate scoring results and issue maps for reporting?

The best way to consolidate scoring results and issue maps for reporting is to merge them with questions.json to create per-question records, grouped summaries, and trend analysis in JSON and Markdown formats.

Why does my assessment report JSON output show missing issue data?

Your assessment report JSON output shows missing issue data when the input issue-map.json is incomplete or fails to map correctly to the corresponding scoring-results.json entries during consolidation.