problem-statement SKILL.md skillA

problem-statement from ninjasln-labs/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ninjasln-labs/agent-skills/problem-statement@v1.1.0

Pins v1.1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ninjasln-labs/agent-skills
Path
problem-statement/SKILL.md
Versions recorded
4
Latest version
v1.1.0, committed Oct 2, 2026
First version recorded
Aug 3, 2026
Size
12,246 bytes
Repository stars
3
License
none declared

Write a user-centered problem statement with who is blocked, what they are trying to do, why it matters, and how it feels. Use when framing discovery, prioritization, or a PRD.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Problem Statement

## Purpose
Articulate a problem from the user's perspective using an empathy-driven framework that captures who they are, what they're trying to do, what's blocking them, why, and how it makes them feel. Use this to align stakeholders on the problem before jumping to solutions, and to frame product work around user outcomes rather than feature requests.

This is not a requirements doc—it's a human-centered problem narrative that ensures you're solving a problem worth solving.

## Input

**Works best with:** Who the user is and what they're struggling to do.
**Also useful:** What's blocking them, why it matters, how it feels, and supporting evidence.

Anything supplied with the invocation itself — text after the skill name, a pasted context dump, or an appended `ARGUMENTS:` line — counts as answers already given. Use it and skip whatever it covers; don't re-ask.

**Arriving empty-handed? That works too.** The skill asks for the user and their goal first — a problem statement without a specific 'who' is a solution looking for cover.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ninjasln-labs/agent-skills/problem-statement@sha256:d2981c1413469c86

The line at the top of this page pins the label v1.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_walf6x6qc4qxj7qp.svg)](https://markdownregistry.com/a/art_walf6x6qc4qxj7qp)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Aug 3, 2026 and Oct 2, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
v1.1.0 latest2026-10-02 fae63b1 12,246 BA view · diff
v1.0.32026-09-22 75c75c0 10,282 BA view · diff
v1.0.02026-09-07 571fb57 10,223 BA view · diff
git:20260803.cf548c92026-08-03 cf548c9 10,153 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12246 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ninjasln-labs/agent-skills · 3 stars · license none declared · pushed 2026-10-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_walf6x6qc4qxj7qp
GET https://markdownregistry.com/api/v1/resolve?ref=ninjasln-labs/agent-skills/problem-statement
GET https://markdownregistry.com/api/v1/blob/d2981c1413469c8618a1d4f04ce57e8a92214fb4ed10f05f8b87a9f83fef3804

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ninjasln-labs/agent-skills

accessibility-auditor SKILL.md skill
ninjasln-labs/agent-skills · accessibility-auditor/SKILL.md · Comprehensive WCAG 2.1 AA compliance testing combining automated axe-core scans with manual keyboard navigation and…
v1.2.0 · audit A · 3 stars
agent-dispatch SKILL.md skill
ninjasln-labs/agent-skills · agent-dispatch/SKILL.md · User-invoked only: run it when the user explicitly asks to hand work to an external agent CLI, never on your own…
v1.5.6 · audit A · 3 stars
api-contract-validator SKILL.md skill
ninjasln-labs/agent-skills · api-contract-validator/SKILL.md · Validate API responses against OpenAPI/Swagger specifications, JSON Schema definitions, and GraphQL schemas to prevent…
v1.1.1 · audit A · 3 stars
architecture-patterns SKILL.md skill
ninjasln-labs/agent-skills · architecture-patterns/SKILL.md · Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven…
v1.2.0 · audit A · 3 stars
audit-item SKILL.md skill
ninjasln-labs/agent-skills · audit-item/SKILL.md · Track audit/review findings as numbered issue files (audit-items/NNN-slug.md, under the directory the project keeps…
v1.1.0 · audit A · 3 stars
autonomous-investigation SKILL.md skill
ninjasln-labs/agent-skills · autonomous-investigation/SKILL.md · The evidence protocol behind recurring competitive and market investigation skills — market scans, competitive…
v1.2.0 · audit A · 3 stars
battle-card-builder SKILL.md skill
ninjasln-labs/agent-skills · battle-card-builder/SKILL.md · Research and draft a competitive battle card from public evidence — every claim labeled and sourced. Use when a rep…
v1.1.1 · audit A · 3 stars
cicd-pipeline SKILL.md skill
ninjasln-labs/agent-skills · cicd-pipeline/SKILL.md · Configure testing in CI/CD pipelines for GitHub Actions, Jenkins, and GitLab CI: shards, parallelization, wait-on…
v1.2.0 · audit A · 3 stars
code-review SKILL.md skill
ninjasln-labs/agent-skills · code-review/SKILL.md · Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code…
v1.1.0 · audit A · 3 stars
codebase-design SKILL.md skill
ninjasln-labs/agent-skills · codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
v1.0.1 · audit A · 3 stars
company-intel SKILL.md skill
ninjasln-labs/agent-skills · company-intel/SKILL.md · Research a company, industry, or competitor set using web search and seven analytical lenses. Use when you need…
v1.1.1 · audit A · 3 stars
competitive-analysis-process SKILL.md skill
ninjasln-labs/agent-skills · competitive-analysis-process/SKILL.md · Orchestrate a complete competitive analysis end to end: market landscape, product-level comparison, ability to fulfill…
v1.1.1 · audit A · 3 stars

Every file in ninjasln-labs/agent-skills

Other files named problem-statement

problem-statement SKILL.md skill
deanpeters/product-manager-skills · skills/problem-statement/SKILL.md · Write a user-centered problem statement with who is blocked, what they are trying to do, why it matters, and how it…
git:20260810.b68bf96 · audit A · 7,599 stars

Browse by kind, by grade A, or by owner.