Agent skill

Developer Docs Audience Research

by hashgraph-online in hashgraph-online/awesome-codex-plugins

Research developer documentation audiences by mapping user goals, learning objectives, business goals, developer traits, user questions, personas, user stories, journey maps, and friction logs.

MITAuto-check passedProduct & Project Management

Install Developer Docs Audience Research

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill developer-docs-audience-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins developer-docs-audience-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/LVTD-LLC/skills/skills/developer-docs-audience-research .claude/skills/developer-docs-audience-research && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
developer-docs-audience-research
GitHub stars
1.2k
Token cost
~913 tokens
SKILL.md length
368 words
Files
5 (incl. references)
Skills in repo
736
Repo updated
First seen
Licence
MIT

At a glance

Research developer documentation audiences by mapping user goals, learning objectives, business goals, developer traits, user questions, personas, user stories, journey maps, and friction logs.

  • Works in 5 steps: Load guidelines.md to choose the… → Start from the user's doc artifact or… → Identify user goals, learning… → …
  • Planning docs for APIs
  • SKILL.md covers Quick Start, Default Output, Contents and Core Posture
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Developer Docs Audience Research is an agent skill from hashgraph-online/awesome-codex-plugins. Research developer documentation audiences by mapping user goals, learning objectives, business goals, developer traits, user questions, personas, user stories, journey maps, and friction logs. Use when planning docs for APIs, SDKs, platforms, CLIs, developer tools, onboarding guides, SaaS docs, or support-heavy docs before writing or restructuring content.

Its SKILL.md is about 910 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `guidelines.md`, `references/core/knowledge.md` and `workflows/define-learning-objectives.md`). Compatibility notes: Codex, Claude Code, and other Agent Skills-compatible clients.

It sits in Product & Project Management, covering Market research, Lesson planning and User stories. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is MIT.

When your agent uses it

  • Planning docs for APIs
  • Developer tools
  • Onboarding guides
  • Support-heavy docs before writing

Example prompts

  • “/developer-docs-audience-research”

Requirements

  • Compatibility (from SKILL.md): Codex, Claude Code, and other Agent Skills-compatible clients.

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Load guidelines.md to choose the smallest useful reference set.
  2. Start from the user's doc artifact or product surface, not from a generic audience label.
  3. Identify user goals, learning objectives, business goals, user traits, questions, and missing knowledge.
  4. Use workflows/map-doc-audience.md when the user needs a full audience brief.
  5. Mark assumptions and recommend validation through user conversations, support data, analytics, or a friction log.

What it can do on your machine

Read from SKILL.md and the folder at commit 16b4156. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • link.springer.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Codex, Claude Code, and other Agent Skills-compatible clients.

    From compatibility in the SKILL.md frontmatter.

Context cost

Developer Docs Audience Research loads about 913 tokens when it runs, and up to ~3.1k if it reads all its reference files. Until then it costs about 98 tokens; SKILL.md has 368 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~98
When it runs · the whole SKILL.md, loaded when a task matches
~913
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 16b4156, republished under its MIT licence (© hashgraph-online). 368 words, ~913 tokens.

Download SKILL.mdSave it as .claude/skills/developer-docs-audience-research/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
developer-docs-audience-research
description
Research developer documentation audiences by mapping user goals, learning objectives, business goals, developer traits, user questions, personas, user stories, journey maps, and friction logs. Use when planning docs for APIs, SDKs, platforms, CLIs, developer tools, onboarding guides, SaaS docs, or support-heavy docs before writing or restructuring content.
compatibility
Codex, Claude Code, and other Agent Skills-compatible clients.
license
MIT
metadata.version
0.1.0
metadata.displayName
Developer Docs Audience Research
metadata.category
Writing
metadata.tags
developer-docs,technical-writing,documentation,user-research,audience-research

Developer Docs Audience Research

Use this skill to understand who developer documentation is for before planning, writing, or reorganizing docs. It helps agents turn vague audiences into concrete users, goals, questions, journeys, and validation work.

This skill is derived from Jared Bhatti, Zachary Sarah Corleissen, Jen Lambourne, David Nunez, and Heidi Waterhouse's Docs for Developers: An Engineer's Field Guide to Technical Writing, especially Chapter 1, "Understanding your audience." It is expanded with paraphrased guidance from Christopher Gales and the Splunk Documentation Team's The Product Is Docs: Writing Technical Documentation in a Product Development Group, especially Chapter 3, "Audience," Chapter 9, "Learning Objectives," and Chapter 25, "Writing SaaS Documentation." Do not copy book prose into user outputs. Source: https://link.springer.com/book/10.1007/978-1-4842-7217-6

Quick Start

  1. Load guidelines.md to choose the smallest useful reference set.
  2. Start from the user's doc artifact or product surface, not from a generic audience label.
  3. Identify user goals, learning objectives, business goals, user traits, questions, and missing knowledge.
  4. Use workflows/map-doc-audience.md when the user needs a full audience brief.
  5. Mark assumptions and recommend validation through user conversations, support data, analytics, or a friction log.
Show full SKILL.md (181 more words)Show less

Default Output

When researching an audience, return:

  1. Audience snapshot - primary and secondary users, roles, skill level, environment, and constraints.
  2. Goals - user goals and business goals that the docs must support.
  3. Learning objective - starting point, destination, and exit criteria when useful.
  4. User questions - setup, concept, task, API, troubleshooting, and decision questions.
  5. Research artifacts - audience definition, persona, user story, journey map, or friction log entries when useful.
  6. Assumptions and gaps - what is inferred versus verified.
  7. Validation plan - the next interviews, data sources, or product walk-throughs.

Contents

NeedStart Here
Understand audience conceptsreferences/core/knowledge.md
Apply research rulesreferences/core/knowledge.md
See concise examplesreferences/core/knowledge.md
Produce an audience briefworkflows/map-doc-audience.md
Define learning objectivesworkflows/define-learning-objectives.md
Route by taskguidelines.md

Core Posture

  • Treat "developer" as too broad until narrowed by task, context, skill, and environment.
  • Separate what users need from what internal teams want to say.
  • Distinguish durable audience definitions from specific personas.
  • Prefer evidence over assumptions, but preserve assumptions clearly when evidence is not available yet.
  • Let audience findings and learning objectives shape content type, order, depth, examples, and success metrics.

© hashgraph-online, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in plugins/LVTD-LLC/skills/skills/developer-docs-audience-research of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • guidelines.md
  • references/core/knowledge.md
  • workflows/define-learning-objectives.md
  • workflows/map-doc-audience.md

Open the folder on GitHubat commit 16b4156

Compare with similar skills

Developer Docs Audience Research next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Developer Docs Audience Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Developer Docs Audience Research this skillhashgraph-online/awesome-codex-plugins1.2k—~913Automated safety check: PassMIT
09 Customer Insight Globalminhnv0807/ai-business-skills608—~3.6kAutomated safety check: PassMIT
User Story Mappingdeanpeters/Product-Manager-Skills7.2k2 repos~2.8kAutomated safety check: PassCustom licence
Super Product Ownersyahiidkamil/Software-Engineer-AI-Agent-Atlas397—~7.9kAutomated safety check: PassNone
China Customer Researchlintendo/Axhub-Skills127—~607Automated safety check: PassMIT
App User Story QAmajiayu000/spellbook286—~2.1kAutomated safety check: PassMIT

Similar skills

  • 09 Customer Insight Global

    minhnv0807/ai-business-skills

    A skill your agent uses when the user needs to understand customers deeply enough to write copy and pick targeting — consumer versus shopper, JTBD, layered persona, internal monologue, pain map…

    608 GitHub stars~3.6k tokensUpdated 25 days ago
    Product & Project ManagementAuto-check passed
  • User Story Mapping

    deanpeters/Product-Manager-Skills

    Lays out a user journey as activities, steps, and tasks on a two-dimensional map that then informs backlog slicing.

    7.2k GitHub starsUsed in 2 repos~2.8k tokens
    Product & Project ManagementAuto-check passed
  • Super Product Owner

    syahiidkamil/Software-Engineer-AI-Agent-Atlas

    Complete Product Owner / Product Manager capability — a wiki-style knowledge map of product practice in active software development: the role and its boundaries, strategy cascade (vision → OKRs →…

    397 GitHub stars~7.9k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check passed
  • China Customer Research

    lintendo/Axhub-Skills

    A skill your agent uses when 需要在中国、海外或跨市场场景中开展客户研究、用户研究、VOC、ICP、JTBD、Persona、竞品口碑、购买或流失原因分析,或从访谈、问卷、工单、社区与评论中为需求分析和 PRD 建立客户证据。

    127 GitHub stars~607 tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • App User Story QA

    majiayu000/spellbook

    End-to-end app feature inventory and user-story testing workflow with a canonical tracker.

    286 GitHub stars~2.1k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Product Discovery

    majiayu000/spellbook

    Product discovery and market research expert. An agent skill from majiayu000/spellbook.

    286 GitHub stars~3.3k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 736 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated yesterday
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.2k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated yesterday
    Auto-check passed

Questions about Developer Docs Audience Research

What does Developer Docs Audience Research do?

Research developer documentation audiences by mapping user goals, learning objectives, business goals, developer traits, user questions, personas, user stories, journey maps, and friction logs. Developer Docs Audience Research is an agent skill from hashgraph-online/awesome-codex-plugins. Research developer documentation audiences by mapping user goals, learning objectives, business goals, developer traits, user questions, personas, user stories, journey maps, and friction logs.

When should I use Developer Docs Audience Research?

Developer Docs Audience Research fits situations like: planning docs for APIs; developer tools; onboarding guides; support-heavy docs before writing.

How do I install Developer Docs Audience Research in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill developer-docs-audience-research -a claude-code`. Or copy the skill folder (plugins/LVTD-LLC/skills/skills/developer-docs-audience-research in hashgraph-online/awesome-codex-plugins) into .claude/skills/developer-docs-audience-research in your project. Claude Code loads it when a task matches its description.

How do I install Developer Docs Audience Research in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill developer-docs-audience-research -a codex`. Or copy the skill folder (plugins/LVTD-LLC/skills/skills/developer-docs-audience-research in hashgraph-online/awesome-codex-plugins) into .agents/skills/developer-docs-audience-research in your project. Codex loads it when a task matches its description.

Can I use Developer Docs Audience Research in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill developer-docs-audience-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/developer-docs-audience-research, .gemini/skills/developer-docs-audience-research, .github/skills/developer-docs-audience-research and .opencode/skills/developer-docs-audience-research in your project.

What does Developer Docs Audience Research need to run?

SKILL.md names no scripts, command-line tools or credentials: Developer Docs Audience Research is instructions for the agent only. Compatibility (from SKILL.md): Codex, Claude Code, and other Agent Skills-compatible clients..

Does Developer Docs Audience Research access the network?

SKILL.md names 1 domain. As links in the text: link.springer.com. This is read from the text; nothing was executed.

Is Developer Docs Audience Research safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Developer Docs Audience Research use?

Developer Docs Audience Research is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Developer Docs Audience Research use?

About 913 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.2k tokens, read only when the agent opens those files.

What are the alternatives to Developer Docs Audience Research?

Skills that share tags, products or a category with Developer Docs Audience Research: 09 Customer Insight Global (minhnv0807/ai-business-skills, 608 stars), User Story Mapping (deanpeters/Product-Manager-Skills, 7.2k stars), Super Product Owner (syahiidkamil/Software-Engineer-AI-Agent-Atlas, 397 stars) and China Customer Research (lintendo/Axhub-Skills, 127 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Developer Docs Audience Research?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,232 GitHub stars. The repository holds 736 skills in this directory. The repository was last updated on October 6, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.