CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

data-manager-api-audience-ingestion

Guides developers through managing (adding, removing, and clearing) audience members for Google products using the Data Manager API and its associated client libraries. Use this skill when the user wants to upload audience members, remove specific users, or clear/replace an entire audience for Customer Match, mobile device ID audiences, or any other audience use case supported by the Data Manager API. Don't use for uploading events or conversions (use the data-manager-api-event-ingestion skill).

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured skill body: clear sequenced workflow with validation checkpoints and a status-polling feedback loop, dense non-obvious gotchas, and real one-level-deep bundle references. The main improvement opportunities are moving the verbose diagnostics walkthrough into a reference file and including a minimal inline request snippet so the skill is actionable even when external links are unavailable.

Suggestions

Move the detailed 'Retrieving Request Status (Diagnostics)' field-by-field walkthrough into a references/ file (like formatting.md), keeping only the polling cadence and top-level status check inline.

Add one short inline code snippet showing a minimal IngestAudienceMembersRequest (destination, terms_of_service, encoding) so the skill remains actionable without fetching the external sample.

Trim Step 1's guide table by collapsing the two destinations' shared columns, since the row content largely duplicates the destination/use-case decision already made.

DimensionReasoningScore

Conciseness

The body is dense and efficient: it spends its tokens on non-obvious material (field-name gotchas like 'email_address not hashed_email', enum values, async-status caveats) and pushes bulk documentation to linked guides rather than explaining concepts Claude already knows. It sits at the 4 anchor ('efficient; minor instances that could be trimmed') rather than 5 because the ~50-line diagnostics/error-handling section repeats status-field walkthroughs in prose that could be tightened or moved to a reference.

4 / 5

Actionability

Guidance is highly concrete — exact request types (IngestAudienceMembersRequest, RemoveAudienceMembersRequest), method names, required fields, the validate_only option, and a per-language table of code samples to retrieve. It earns 4 ('mostly executable guidance... minor gaps') rather than 5 because no inline code snippet exists; execution depends on fetching external samples and guides, leaving a gap if those are unreachable.

4 / 5

Workflow Clarity

The four-step workflow is clearly sequenced with prerequisites, a [CRITICAL] stop-and-clarify checkpoint for destination type, an implementation checklist, an explicit validation mechanism (validate_only), and a status-retrieval feedback loop with error/warning inspection for the asynchronous batch operation. This matches the 5 anchor ('explicit validation steps; feedback loops for error recovery; checklists') — the batch-operation cap of 3 does not apply since validation and verification are present.

5 / 5

Progressive Disclosure

The SKILL.md works as an overview: both bundle references (references/create-audience.md, references/formatting.md) exist, are clearly signaled one level deep, and bulk detail is delegated to linked guides. It scores 4 rather than 5 because the long inline Error Handling & Troubleshooting walkthrough is content that arguably belongs in a separate reference file, leaving a minor organization gap.

4 / 5

Total

17

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete, comprehensive actions; explicit use-when and don't-use-when triggers; and clear separation from the sibling event-ingestion skill. The only minor gap is a handful of natural synonyms a user might say (e.g., 'audience list', 'suppression list').

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'managing (adding, removing, and clearing) audience members', 'upload audience members, remove specific users, or clear/replace an entire audience' — anchored to a named API and client libraries, giving comprehensive coverage of the skill's operations. It matches the top anchor 'lists multiple specific concrete actions; comprehensive coverage' and not the level below, which allows 'minor gaps in coverage'.

5 / 5

Completeness

It explicitly answers 'what' ('Guides developers through managing (adding, removing, and clearing) audience members for Google products using the Data Manager API and its associated client libraries') and 'when' ('Use this skill when the user wants to upload audience members, remove specific users, or clear/replace an entire audience...') with concrete trigger phrases, plus when-not-to guidance. This matches the top anchor exactly; the 4 anchor's weaker 'when' does not apply.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'upload audience members', 'remove specific users', 'clear/replace an entire audience', 'Customer Match', and 'mobile device ID audiences' give good keyword coverage, plus an explicit negative trigger ('Don't use for uploading events or conversions'). It falls just short of the 5 anchor because a few common user phrasings (e.g., 'audience list', 'suppression list', generic 'audience upload') are absent, but it is clearly above the 'a few natural terms missing' threshold being met only partially.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (audience-member management via the Data Manager API) and actively reduces conflict risk by redirecting event/conversion ingestion to the sibling 'data-manager-api-event-ingestion' skill. Triggers are distinct with minimal overlap risk, matching the top anchor.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

google/skills

Path

skills/ads/data-manager-api-audience-ingestion/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.