OpenCLI Sitemap Author
Create and maintain site task graphs for browser agents to navigate effectively.
Evidence shows the skill explicitly prohibits writing secrets, cookies, user-private IDs, and bypassing CAPTCHA/access controls, emphasizing browser state as truth, demonstrating good security awareness and least privilege. However, allowed-tools include Bash(opencli:*), potentially accessing system commands, but the skill mainly guides sitemap file operations without explicit data-flow or user confirmation. Deduction: no explicit user confirmation step, unclear data flow, no rollback mechanism.
The skill provides detailed schema and examples with good self-consistency. However, static review cannot verify execution, and it depends on external opencli tool, browser state, and network, with no tests or error-handling details provided. Deduction: happy path only in docs, abnormal input behavior unclear, external dependencies.
The skill explicitly describes use cases (create/maintain sitemaps), target users (AI agents), and environment requirements (opencli browser), with size heuristics and advice. However, non-fit scenarios are not clarified, trigger conditions depend on 'opencli browser' environment, and reachability in mainland China is not verified. Deduction: boundaries and triggers insufficient, environment fit evidence lacking.
SKILL.md provides clear structure, storage model, schema, and examples, documents v1.1 changelog, follows Apache-2.0 license, maintenance responsibility traceable to repo. But no version number, changelog file, or explicit update mechanism. Deduction: version management and update path unclear.
The skill has clear goals and detailed sitemap authoring specs, producing structured sitemap files directly usable. But its value depends on external opencli tool, and static review cannot verify actual output. Deduction: correctness unverified, cost-benefit not quantified.
Document mentions multiple PoC validations (twitter, hackernews) and Phase 2 audit plans, but static review lacks executable test evidence. Deduction: no third-party execution evidence, fact/inference separation incomplete.
- This skill depends on opencli browser and browser state; static review cannot verify its actual runtime behavior. Use with caution in real environments.
- The skill involves operating on websites; ensure compliance with site terms of service and laws.
- The skill lacks explicit user confirmation mechanisms; consider adding user authorization confirmation in practice.
- Reachability in mainland China is unverified; all features may rely on overseas services.
What does this skill do, and when should you use it?
The OpenCLI sitemap-author skill enables AI agents to create and maintain site sitemaps that are not for SEO but as navigation and execution graphs for agents. It documents page-state signatures, action edges, workflows, and pitfalls so agents can decide where they are, what path to take next, and how to recover. The skill emphasizes small, verifiable sitemaps, prioritizes local overlays, and ensures agents follow user-provided instructions.
Reads existing local and global site sitemaps, verifies current browser state using opencli browser commands (state, find, network, analyze), writes or updates sitemap files under ~/.opencli/sites/<site>/sitemap/ based on observed stable structures, records action edges with required schema and recovery directives, and marks stale items when browser state conflicts.
- After exploring a site, wanting to record the stable workflow you discovered for future agents to reuse.
- Updating sitemap entries when the existing sitemap is stale and disagrees with current browser behavior.
- Promoting local site knowledge into the repo sitemap when agents need structured guidance beyond blind clicking.
- Maintaining sitemaps for frequently used sites, focusing on task-relevant paths and stable anchors.
- Creating partial pages for cross-page UI components like shared card components.
What are this skill's strengths and limitations?
- Emphasizes small, verifiable sitemaps, avoiding crawling the whole site.
- Provides a clear authoring loop and verification requirements.
- Supports local overlays and global promotion, allowing safe iteration.
- Includes partial pages for cross-page UI elements.
- Explicitly marks uncovered routes to manage agent expectations.
- Requires OpenCLI setup and browser bridge extension, which could be a barrier to adoption.
- Primarily for advanced users; the schema may have a steep learning curve.
- No documented test suite; verification relies on manual inspection.
- Effectiveness depends on the maintainer's discipline to keep sitemaps small and accurate.
How do you install this skill?
Install the OpenCLI collection: npx skills add jackwener/opencli --skill opencli-sitemap-author. Requires the OpenCLI runtime and Browser Bridge extension; follow the Quick Start steps in the README.
How do you use this skill?
Trigger with a prompt like: "Record the stable workflow you just discovered for this site" or "Update the sitemap for this site, emphasizing current state." The skill automatically reads existing memory, verifies browser state, and guides you through writing or modifying sitemap files.