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.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/allens0104/adapter-auditAdapter 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 itemtitle— content titleauthor— creator/author nametimestamp/date— publish or capture time
2. Classify fix type
For each missing field, determine the fix strategy:
| Situation | Fix strategy |
|---|---|
Field is computed internally but not in columns | Add to columns list |
Field is computed but stripped by a map step | Pass through the map step + add to columns |
| Field is not computed but can be constructed from existing data | Add construction logic + add to columns |
| Field requires external data not available in the API response | Skip 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
urlin output - After: 32/33 (97%) had
urlin 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:
- total adapters scanned
- per-adapter field coverage table
- fix strategy for each missing field
- list of files changed
- before/after coverage metrics
- risk classification
Key rules
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-allens0104-adapter-audit": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
adapt
Shortest English alias for web-adapt / universal-web-adaptation. Use this when adapting an unfamiliar public website generically before creating any site-specific rules.
site-profile
Short alias for external-site-profile-learning. Use this when investigating, adding, validating, or debugging external website profiles for the 99idea Playwright browser demo.
content-summary
Short alias for content-search-summarization. Use this to search public content platforms, rank the top relevant items, and summarize them with links.
profile
Shortest English alias for site-profile / external-site-profile-learning. Use this when turning an already-proven site flow into a stable reusable external profile.