opencli-adapter-author
Use when writing an OpenCLI adapter for a new site or adding a new command to an existing site. Guides end-to-end from first recon through field decoding, adapter coding, and verify. Replaces opencli-oneshot / opencli-explorer. For ad-hoc browser driving (no adapter), see opencli-browser instead; for a top-level orientation to opencli, see opencli-usage.
Security Assessment
About opencli-adapter-author
The `opencli-adapter-author` skill is designed to guide developers through the process of creating or updating OpenCLI adapters for new websites or adding new commands to existing sites. It provides a structured, end-to-end workflow that ensures an adapter can go from initial reconnaissance to verification within a short time frame, typically under 30 minutes. By following this skill, users can efficiently handle browser-based data extraction, endpoint validation, field decoding, and adapter coding without needing to invent new commands, relying instead on existing OpenCLI tools such as `opencli browser`, `opencli doctor`, `opencli browser init`, and `opencli browser verify`.
The skill’s main capabilities include systematic site reconnaissance, API discovery, endpoint validation, and field mapping. It incorporates decision trees to determine when to use existing site memory, when to perform live browser analysis, and how to handle authentication or token issues. Users are guided through automated patterns for network inspection, state extraction, and script bundle analysis, ensuring that all endpoints and fields are correctly verified. Additional features include trace-enabled debugging, live container focus for verifying page states, and integration with site memory files to streamline repeated adapter creation or updates.
Target users of this skill are developers and automation engineers working with OpenCLI who need to rapidly create or maintain adapters for data extraction tasks. It is particularly useful for those who work with dynamic web pages requiring browser automation and API inspection, and who need a structured, repeatable process to minimize errors. This skill is also suitable for teams that maintain multiple site adapters and want a standardized approach to verifying endpoint correctness and field mapping consistency.
FAQ
How do I start using the opencli-adapter-author skill?
Begin by running `opencli doctor` to ensure your environment is ready. Then check existing site memory files for known endpoints before proceeding to site reconnaissance and API discovery if needed.
Which tools does this skill rely on?
It uses existing OpenCLI commands: `opencli browser *`, `opencli doctor`, `opencli browser init`, and `opencli browser verify`. No new commands are required.
Can I use this skill for real-time push data sources?
Yes, but only if the data is accessible through an HTTP interface. If no suitable HTTP endpoint exists, the skill does not cover it.
What should I do if endpoints in memory are outdated?
If site memory is older than 30 days or endpoints return errors like 401/403, follow the cold-start workflow by performing site reconnaissance and API discovery to locate new endpoints.
Is this skill suitable for all types of websites?
No, it is intended for sites where data can be observed in a browser and is delivered via HTTP, JSON, or HTML. Sites requiring non-standard real-time connections outside HTTP are not supported.
All Files
16 filesInstall opencli-adapter-author
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
jackwener/opencli