Skip to content
cccskills
FreePublished on GitHub

adapter-audit

Use this skill to audit CLI adapter projects (like opencli) for missing output fields, then batch-generate fixes and submit PRs. Turns AI agents into adapter quality reviewers.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror
See how to install

Files included (1)

  • SKILL.md3.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Adapter audit skill

Use this skill when you want to systematically audit and fix CLI adapter projects — for example, scanning all search adapters in opencli for missing url fields and batch-generating patches.

When to use

  • auditing adapter output schemas for missing fields (url, timestamp, thumbnail, etc.)
  • generating batch fixes across many adapters at once
  • preparing multi-file PRs to upstream projects
  • maintaining output consistency across a large adapter registry

Core workflow

1. Scan

Scan all adapters in the target project and classify each by:

  • adapter type (YAML declarative vs TS/JS coded)
  • which output fields are present
  • which standard fields are missing

Standard fields to check:

  • url — direct link to the content item
  • title — content title
  • author — creator/author name
  • timestamp / date — publish or capture time

2. Classify fix type

For each missing field, determine the fix strategy:

SituationFix strategy
Field is computed internally but not in columnsAdd to columns list
Field is computed but stripped by a map stepPass through the map step + add to columns
Field is not computed but can be constructed from existing dataAdd construction logic + add to columns
Field requires external data not available in the API responseSkip or mark as "needs upstream API change"

3. Fix

Apply fixes using the minimum change principle:

  • For YAML adapters: add field to return object + map step + columns array
  • For TS adapters: add field to return object + columns array
  • Never change existing fields or behavior
  • Only add new fields

4. Verify

After fixing, run the project's existing tests:

npm run build    # ensure TS compiles
npm test         # ensure nothing breaks

5. Submit

Create a single well-documented PR with:

  • clear title describing the scope
  • table showing before/after coverage
  • per-adapter fix type classification
  • risk assessment (should always be "additive only")

Proven example

This skill was used to audit opencli's 33 search adapters:

  • Before: 22/33 (67%) had url in output
  • After: 32/33 (97%) had url in output
  • Fix types used: columns-only (3), map-passthrough (2), construct-from-data (4)
  • Files changed: 9
  • Lines changed: +17 / -10
  • PR: merged within hours, all CI green

Output contract

The audit output should include:

  1. total adapters scanned
  2. per-adapter field coverage table
  3. fix strategy for each missing field
  4. list of files changed
  5. before/after coverage metrics
  6. risk classification

Key rules

  • Never modify existing output fields — only add missing ones
  • Prefer constructing URLs from existing API data over adding new API calls
  • Skip fields that genuinely don't apply (e.g., url for dictionary word lookup)
  • Always verify the constructed URL format is correct for the platform
  • Group all fixes into a single PR for easier review

Quick invocation template

Use /adapter-audit to scan all search adapters in this CLI project for missing url fields, fix them, and prepare a PR.

请用 /adapter-audit 扫描这个 CLI 项目里所有 search adapter 的缺失字段，批量修复并准备 PR。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

<provider-id>

Free

<What it does, one line>. Trigger phrases: <phrases>.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 23, 2026

academic-pptx

Free

Use this skill whenever the user wants to create or improve a presentation for an academic context — conference papers, seminar talks, thesis defenses, grant briefings, lab meetings, invited lectures, or any presentation where the audience will evaluate reasoning and evidence. Triggers include: 'conference talk', 'seminar slides', 'thesis defense', 'research presentation', 'academic deck', 'academic presentation'. Also triggers when the user asks to 'make slides' in combination with academic content (e.g., 'make slides for my paper on X', 'create a presentation for my dissertation defense', 'build a deck for my grant proposal'). This skill governs CONTENT and STRUCTURE decisions. For the technical work of creating or editing the .pptx file itself, also read the pptx SKILL.md.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 23, 2026

adapt

Free

Shortest English alias for web-adapt / universal-web-adaptation. Use this when adapting an unfamiliar public website generically before creating any site-specific rules.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 23, 2026

ads

Free

Operate professional paid advertising across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, and X. Use for account intake, source-grounded audits, strategy, budget and measurement planning, creative production, experiments, reporting, monitoring, and explicitly approved campaign changes. Also trigger on PPC, paid social, retail media, attribution, tracking, landing pages, cross-platform conversion totals, negative keywords or search terms, beta-feature scoring, stale platform claims, API-token or credential setup, campaign deletion, and safe Claude Ads installation or uninstall.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 23, 2026

ads-amazon

Free

Audit Amazon Ads profiles, regions, Sponsored Products, Sponsored Brands, Sponsored Display, DSP, portfolios, targeting, search terms, retail readiness, creative, budgets, ACOS, TACOS, reporting, and policy. Use for Amazon Ads, sponsored ads, Amazon PPC, ACOS, TACOS, ASIN advertising, Amazon DSP, or retail-media optimization.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 23, 2026

ads-apple

Free

Audit Apple Ads measurement, AdServices and AdAttributionKit, campaign and keyword structure, Search Match, App Store placements, custom product pages, bidding, budgets, MMP reconciliation, and policy. Use for Apple Ads, Apple Search Ads, App Store ads, Search Match, custom product pages, AdServices, or Apple app-install campaigns.

The English summary is being prepared. Showing the original description.

gabrielmoreira/agent-skills-mirror19Updated Oct 23, 2026

See all skills by gabrielmoreira

Report a problem with this skill