discovery-brief SKILL.md skillA

discovery-brief from jqaisystems/jqai-ai-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jqaisystems/jqai-ai-skills/discovery-brief@git:20260710.88e305c

Pins git:20260710.88e305c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jqaisystems/jqai-ai-skills
Path
skills/discovery-brief/SKILL.md
Versions recorded
1
Latest version
git:20260710.88e305c, committed Jul 10, 2026
Size
3,335 bytes
Repository stars
3
License
MIT

Run a structured discovery interview for a new client project and turn the answers into a completed brief plus a strategy starter document. Conversational, skips what is already known, and never fabricates unanswered questions. Use when the user says "run discovery", "brief for this client", "discovery questionnaire", or "help me figure out what this client needs".

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

# Discovery Brief

A project priced before discovery is a project scoped by hope. This skill runs the discovery conversation and turns the answers into two working documents: the brief (the project's source of truth) and a strategy starter (the first thinking pass).

This is the interview counterpart to a client-facing intake form: the `client-intake-builder` skill generates an HTML questionnaire the CLIENT fills in alone; this skill interviews YOU (or processes the client's answers) and writes the documents.

## Step 1: Read what already exists

Before asking anything, read whatever the user points at: an existing brief, intake form answers, emails, meeting notes, the client's website. Never ask a question the material already answers.

## Step 2: Interview across seven areas

Ask in small batches, not twenty questions at once. Skip known answers.

1. **Business**: what the client does, how they make money, what stage they are at (new, rebrand, growing).
2. **Audience**: who buys now, who they WANT to buy, price positioning (budget, mid, premium).
3. **Competitors**: two or three names, what the client envies or hates about each.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jqaisystems/jqai-ai-skills/discovery-brief@sha256:73b307b7f7acaf6f

The line at the top of this page pins the label git:20260710.88e305c, 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_xd3lasc546n266ri.svg)](https://markdownregistry.com/a/art_xd3lasc546n266ri)

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

Versions

The registry has recorded 1 version of this file, committed on Jul 10, 2026.

versioncommittedcommitsizeaudit
git:20260710.88e305c latest2026-07-10 88e305c 3,335 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 (3335 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

jqaisystems/jqai-ai-skills · 3 stars · license MIT · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xd3lasc546n266ri
GET https://markdownregistry.com/api/v1/resolve?ref=jqaisystems/jqai-ai-skills/discovery-brief
GET https://markdownregistry.com/api/v1/blob/73b307b7f7acaf6feb065313f2af2e3af7157a5c5f6f6fd4cfb0a932373d439d

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 jqaisystems/jqai-ai-skills

skill-name SKILL.md skill
jqaisystems/jqai-ai-skills · skills/_template/SKILL.md · Explain what this skill does, when it should be used, and the user phrases that should trigger it.
git:20260526.9000511 · audit A · 3 stars
agents-md-writer SKILL.md skill
jqaisystems/jqai-ai-skills · skills/agents-md-writer/SKILL.md · Create or update project-level AGENTS.md and CLAUDE.md guidance that maps real skills to project tasks without…
git:20261014.0cdadcf · audit A · 3 stars
ai-image-run-pacing SKILL.md skill
jqaisystems/jqai-ai-skills · skills/ai-image-run-pacing/SKILL.md · Run a batch of AI image generations through a hosted assistant without getting rate limited, losing subject likeness…
git:20260806.5ff6c30 · audit A · 3 stars
automation-state-reconciler SKILL.md skill
jqaisystems/jqai-ai-skills · skills/automation-state-reconciler/SKILL.md · Compare offline automation snapshots and delivery receipts to identify drift, duplicates, missing records, and…
git:20261014.c1a6454 · audit A · 3 stars
backup-readiness-auditor SKILL.md skill
jqaisystems/jqai-ai-skills · skills/backup-readiness-auditor/SKILL.md · Evaluate supplied backup manifests and verification evidence before a migration or recovery decision. Identify…
git:20261014.0cdadcf · audit A · 3 stars
brand-voice-linter SKILL.md skill
jqaisystems/jqai-ai-skills · skills/brand-voice-linter/SKILL.md · Lint copy against a brand voice guide. Scans files for em dashes, buzzword clusters, hedge language, vague…
git:20260611.809260e · audit A · 3 stars
case-study-writer SKILL.md skill
jqaisystems/jqai-ai-skills · skills/case-study-writer/SKILL.md · Write public-safe case studies from private projects, automations, agent workflows, internal tools, demos, or…
git:20260527.f90d5e7 · audit A · 3 stars
client-delivery-auditor SKILL.md skill
jqaisystems/jqai-ai-skills · skills/client-delivery-auditor/SKILL.md · Audit final client deliverables against the agreed scope, verify files and links, and prepare a clear handoff with an…
git:20260714.4835a66 · audit A · 3 stars
client-intake-builder SKILL.md skill
jqaisystems/jqai-ai-skills · skills/client-intake-builder/SKILL.md · Generate a branded, single-file HTML client intake questionnaire for any service business. Picks the right question set…
git:20260611.809260e · audit A · 3 stars
client-workspace-scaffolder SKILL.md skill
jqaisystems/jqai-ai-skills · skills/client-workspace-scaffolder/SKILL.md · Scaffold a complete client project folder from your own reusable structure template, with a filled-in brief file and…
git:20260710.88e305c · audit A · 3 stars
code-deduplicator SKILL.md skill
jqaisystems/jqai-ai-skills · skills/code-deduplicator/SKILL.md · Find duplicated code introduced or touched in the current session, then safely consolidate exact or low-risk duplicates…
git:20260526.32c2e2d · audit A · 3 stars
cold-outreach-writer SKILL.md skill
jqaisystems/jqai-ai-skills · skills/cold-outreach-writer/SKILL.md · Write a personalised cold outreach email from a company research block. Produces one tight email under 180 words built…
git:20260611.809260e · audit A · 3 stars

Every file in jqaisystems/jqai-ai-skills

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