audience-research

boringmarketer/boring-marketing-skillsMarketing & growthProduct & project management

audience-research is a skill in boringmarketer/boring-marketing-skills, last changed 16 Nov 2026. It is instructions only: no scripts, no named hosts and no pre-approved tools.

From the author
Mine where your audience actually talks (reviews, Reddit, YouTube comments, communities) and produce two brand files, audience.md (segments, awareness, jobs-to-be-done, watering holes) and voc.md (verbatim pain/desire/objection language with sources). Use it before positioning or copy work, when launching into a new market, or when copy keeps missing because nobody knows how customers actually describe the problem.

At a glance

What it can touch

  • Instructions only

It is instructions only: no scripts, no named hosts and no pre-approved tools.

How much a skill can do, not whether it is risky.

Pattern check

Nothing flagged

That isn't proof the skill is harmless.

Commit bd5aaed · 20 Nov 2026

How the check works

Pattern check: nothing flagged

That isn't proof the skill is harmless.

QAI Index

59/QI

We rate every listed skill the same way, from 0 to 100.

A guide to compare by, not a verdict on the skill.

How it's scored

How the QAI Index is scored

Adoption · up to 40
GitHub stars on the repo that holds the skill, shared among its skills, and copies of the skill in other repos.
Quality · up to 30
Our pattern check, the format check, a named licence and a description of a sentence or more.
Upkeep · up to 20
How recently the skill's folder changed.
Trust · up to 10
An official collection, or an organisation that has confirmed its domain with GitHub.

Get an email when its check changes.

Keep it with the other skills you use, installed with one command.

Install

Sign in to see how to install it

Free with Google or an email link, no password needed. Then pick your agent and copy its steps.

MIT
Licence
750
Repo stars
Publisher
Files

What it can touch

From the files and frontmatter at commit bd5aaed. This is how much a skill can do, not whether it is risky.

Instructions only

It is instructions only: no scripts, no named hosts and no pre-approved tools.

Pattern check

Pattern check: nothing flagged · commit bd5aaed · 20 Nov 2026

We checked every text file in this skill, at commit bd5aaed on 20 Nov 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.

How the check worksReport an incorrect finding

Format check

Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.

  • Agent Skills specPasses with warnings

    The format our Agent Skills docs set out, held to the strictest version of each rule among the agents we check.

    • Warning

      The frontmatter uses [ ] or { } values. Most agents accept them, but strict validators reject the file. F4

      Fix: Write lists as "- item" lines and maps as indented key: value lines, without anchors or tags.

    • Warning

      Fields outside the spec: when_to_use (read by Claude Code) and argument-hint (read by Claude Code and VS Code). Uploads to the Claude apps and API, and strict validators, reject the file; most agents ignore these fields. O1

      Fix: Delete them for a portable skill, or keep them if you only target the agents that read them.

    • Warning

      metadata values should be text; boring (a map) is not. Some readers turn them into text; others may not. O4

      Fix: Quote each value, for example version: "1.0".

    • Note

      The first sentence of the description is 251 characters. Agents shorten long descriptions, so lead with the main job. D8

      Fix: Start with one short sentence that names the job.

    • Note

      There is no license field, so readers can't tell whether they may reuse the skill. O2

      Fix: Add license: with an SPDX name such as MIT or Apache-2.0, or the name of a bundled licence file.

    • Note

      Reference files over 100 lines with no table of contents at the top: references/voc-mining-judgment.md (101 lines). B5

      Fix: Add a short list of the sections at the top of each.

  • Claude CodePasses

    Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.

    • Note

      The first sentence of the description is 251 characters. Agents shorten long descriptions, so lead with the main job. D8

      Fix: Start with one short sentence that names the job.

    • Note

      Reference files over 100 lines with no table of contents at the top: references/voc-mining-judgment.md (101 lines). B5

      Fix: Add a short list of the sections at the top of each.

  • Claude apps & API uploadFails

    Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.

    • Error

      Upload and packaging fail on fields outside the spec: when_to_use and argument-hint. O1

      Fix: Delete them, and keep your own data under metadata as text values.

    • Note

      The description is 418 characters. The claude.ai Help Center says 200 at most, though Anthropic's API docs and validator allow 1,024. D4

      Fix: If the claude.ai upload refuses it, trim the description to 200 characters.

    • Note

      metadata values should be text; boring (a map) is not. The spec defines metadata as text to text. O4

      Fix: Quote each value, for example version: "1.0".

    • Note

      Reference files over 100 lines with no table of contents at the top: references/voc-mining-judgment.md (101 lines). B5

      Fix: Add a short list of the sections at the top of each.

  • OpenAI (Codex & API)Passes with warnings

    Codex finds SKILL.md by its exact name and needs a description; OpenAI's Skills API checks the frontmatter against the spec and caps uploads.

    • Warning

      Fields outside the spec: when_to_use and argument-hint. Codex ignores them; OpenAI doesn't say whether its upload accepts them. O1

      Fix: Delete them, or move your own data under metadata as text values.

    • Warning

      metadata values should be text; boring (a map) is not. OpenAI's upload follows the spec's text-to-text rule. O4

      Fix: Quote each value, for example version: "1.0".

    • Note

      The first sentence of the description is 251 characters. Agents shorten long descriptions, so lead with the main job. D8

      Fix: Start with one short sentence that names the job.

  • VS Code & CopilotPasses

    VS Code reads skills one folder below .github/skills, .claude/skills or .agents/skills and falls back to the folder name when the name is missing or differs; GitHub's Copilot docs require the exact name SKILL.md.

    • Note

      VS Code ignores fields it doesn't support: when_to_use. O1

      Fix: Delete them unless another agent you target reads them.

SKILL.md

Files

Changelog

Newest first: each commit that changed its folder on GitHub, and each change to its listing here.

  1. Listed on QAI
  2. Updated: 4.1.1: sharper visual check for ad creative (brand name, offer line, … (7c6678c (opens in a new tab))
  3. Updated: Boring Marketing Skills 4.1.0 (3f2b695 (opens in a new tab))
  4. Updated: Sharper deliverables: finished work first, claim checks, cold outboun… (2e2251f (opens in a new tab))
  5. Updated: Boring Marketing Skills 4.0.0 (42f2599 (opens in a new tab))

QAI Index badge

Show this skill's QAI Index in a README or on a website. It links back to this page and changes when we refresh the catalog.

Preview of the QAI Index badge
[![QAI Index](https://qai.io/badge/skills/boringmarketer/boring-marketing-skills/audience-research.svg)](https://qai.io/skills/boringmarketer/boring-marketing-skills/audience-research)

More from boringmarketer/boring-marketing-skills

SkillQAI IndexWhat it can touchPattern checkLicenceUpdated
59/QI
  • Runs shell commands
  • Bundles scripts
Pattern check: Nothing flaggedMIT16 Nov 2026
59/QI
  • Names web addresses
Pattern check: Nothing flaggedMIT16 Nov 2026
59/QI
  • Instructions only
Pattern check: Nothing flaggedMIT16 Nov 2026
59/QI
  • Runs shell commands
Pattern check: Nothing flaggedMIT16 Nov 2026
59/QI
  • Instructions only
Pattern check: Nothing flaggedMIT16 Nov 2026
54/QI
  • Touches credentials
  • Installs more skills
  • +4 more
Pattern check: 2 items to reviewMIT16 Nov 2026
All skills in boringmarketer/boring-marketing-skills

Other Marketing & growth skills

Same category, most repo stars first.

SkillQAI IndexWhat it can touchPattern checkLicenceUpdated
76/QI
  • Instructions only
Pattern check: Nothing flaggedMIT27 Sept 2026
76/QI
  • Instructions only
Pattern check: Nothing flaggedMIT27 Sept 2026
82/QI
  • Names web addresses
Pattern check: Nothing flaggedApache 2.020 Apr 2026
77/QI
  • Reaches the network
Pattern check: Nothing flaggedMIT13 Oct 2026
62/QI
  • Runs shell commands
  • Names web addresses
Pattern check: Nothing flaggedApache 2.030 Jun 2026
68/QI
  • Runs shell commands
  • Names web addresses
Pattern check: Nothing flaggedApache 2.018 Aug 2026

Repo facts from GitHub on 20 Nov 2026. Files read at commit bd5aaed.

QAI did not write these skills and is not affiliated with their authors unless a page says so. Logos and icons belong to their owners and are not a mark of approval. How we check