persona-coverage

Analyze documentation coverage for decision-makers and implementers to produce a balanced persona report.

78|252|Updated Feb 7, 2024
One-click install
npx skills add https://github.com/hashicorp/web-unified-docs --skill persona-coverage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: persona-coverage
Source: https://github.com/hashicorp/web-unified-docs/tree/main/content/well-architected-framework/docs/.claude/skills/persona-coverage
Command: npx skills add https://github.com/hashicorp/web-unified-docs --skill persona-coverage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill analyzes documentation coverage to ensure both decision-makers and implementers are effectively served, producing a balanced persona report that informs revisions.

Core Features & Use Cases

  • Content distribution analysis across decision-maker and implementer personas
  • Section-by-section balance breakdown with actionable recommendations
  • Rebalancing guidance for doc teams to improve coverage and clarity

Quick Start

Use the persona-coverage skill to analyze a single document: /persona-coverage docs/path/to/document.mdx Analyze multiple documents: /persona-coverage docs/section/.mdx Detailed breakdown: /persona-coverage docs/document.mdx --verbose Compare persona balance across sections: /persona-coverage docs/section/.mdx --compare

Frequently Asked Questions about persona-coverage

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

FAQPage Schema
How do I analyze documentation coverage for different reader personas?

Documentation coverage analysis evaluates content distribution across decision-maker and implementer personas, generating a balanced report that identifies section-by-section gaps and provides actionable revision recommendations.

What is the best way to balance technical docs for both managers and engineers?

Balancing technical docs involves measuring content distribution per persona to produce a balanced report, identifying gaps where decision-makers or implementers lack sufficient information, and applying rebalancing guidance for doc teams.

How do I identify content gaps in my documentation for decision-makers?

Identifying content gaps for decision-makers requires applying persona coverage analysis across documentation sections to measure distribution metrics, pinpointing areas lacking strategic context, and delivering actionable recommendations for revisions.

Can I compare persona balance across multiple documentation sections?

Yes, you can compare persona balance across multiple documentation sections by analyzing multiple .mdx files, which evaluates coverage distribution per persona and highlights gaps across the entire section for targeted revisions.

How do I generate actionable recommendations to improve documentation clarity?

Generating actionable recommendations to improve documentation clarity requires evaluating persona balance and distribution metrics across sections, which outputs targeted rebalancing guidance for doc teams to improve coverage.

Does persona coverage analysis work with markdown files?

Yes, persona coverage analysis works with markdown files, specifically processing .mdx documents to evaluate content balance and identify gaps for decision-makers and implementers across single or multiple files.