persona-score

Audit repository file trees against persona-based scorecards to calculate persona-debt.

30|12|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/anthony-chaudhary/fak --skill persona-score
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: persona-score
Source: https://github.com/anthony-chaudhary/fak/tree/main/.claude/skills/persona-score
Command: npx skills add https://github.com/anthony-chaudhary/fak --skill persona-score

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of project drift where a repository becomes inaccessible to its target users because essential affordances like documentation, installation paths, or deployment guides are missing or broken.

Core Features & Use Cases

  • Persona-Debt Tracking: Measures the gap between what a user needs (e.g., a free-tier dev needing a binary) and what is actually present in the tree.
  • Actionable Work-Lists: Generates a prioritized list of missing affordances to retire debt, ensuring the project serves its top-10 personas.
  • Regression Sentinel: Acts as a gatekeeper to ensure that future changes do not accidentally break the entry paths for critical users like infra engineers or researchers.

Quick Start

Run the persona-score skill to generate a readiness report and identify the most critical missing affordances in the current repository.

Frequently Asked Questions about persona-score

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

FAQPage Schema
How do I audit my repository for missing documentation and user affordances?

To audit your repository for missing documentation and affordances, run the persona-score skill. It analyzes the file tree against a scorecard of hard requirements to calculate persona-debt and generates a prioritized work-list of missing items.

What is persona-debt and how does it affect project accessibility?

Persona-debt is the gap between what a target user needs, such as installation paths or deployment guides, and what is actually present in the repository tree. Accumulating this debt makes the project inaccessible to critical users like infra engineers.

How do I prevent repository drift from breaking entry paths for new users?

You can prevent repository drift by using the persona-score skill as a regression sentinel. It acts as a gatekeeper to ensure future changes do not accidentally break the entry paths and affordances required by your top-10 defined personas.

Can I use a scorecard to track onboarding readiness for specific user personas?

Yes, you can use a scorecard to track onboarding readiness by evaluating the repository against hard requirements for defined user personas. The skill measures this readiness deterministically and provides a repeatable framework for maintaining user-experience standards.

Do I need Python to run a persona readiness audit on my codebase?

Yes, you need Python installed to run a persona readiness audit. The skill depends on Python scripts to analyze the file tree, evaluate affordances against the scorecard, and generate the work-list for retiring project debt.

What is the best way to generate an actionable work-list for missing repository affordances?

The best way to generate an actionable work-list for missing affordances is to run a persona-debt audit. The skill evaluates the file tree and outputs a prioritized list targeting the most critical missing requirements for your top-10 personas.