← Back to Skills Marketplace
craftslab

diffmanifests

by Jia · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ Security Clean
269
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install diffmanifests
Description
Compare manifest XML files via Gerrit and Gitiles APIs, producing JSON/txt/xlsx reports. Use when comparing Android or repo manifest versions, diffing manife...
README (SKILL.md)

diffmanifests Skill (OpenClaw)

Use the diffmanifests CLI to compare two manifest XML files and get detailed commit/change reports. Install with pip install diffmanifests. Configuration lives in a JSON file; all four CLI arguments are required.

Installation

pip install diffmanifests

Upgrade: pip install diffmanifests --upgrade

Configuration

Configuration is read from a JSON file. Bundled config (packed with this skill for OpenClaw hub): use config.json in this skill directory. Reference structure:

Section Parameter Type Description
gerrit url string Gerrit instance URL
user string Auth username
pass string Password or API token
query.option array e.g. ["CURRENT_REVISION"]
gitiles url string Gitiles instance URL
user string Auth username
pass string Password or API token
retry integer Retry attempts (default: 1)
timeout integer Timeout in seconds (-1 = no timeout)

Example config.json:

{
  "gerrit": {
    "url": "https://android-review.googlesource.com",
    "user": "",
    "pass": "",
    "query": { "option": ["CURRENT_REVISION"] }
  },
  "gitiles": {
    "url": "https://android.googlesource.com",
    "user": "",
    "pass": "",
    "retry": 1,
    "timeout": -1
  }
}

Parameters (CLI)

Argument Required Description
--config-file Path to configuration JSON file
--manifest1-file Path to first (older) manifest XML
--manifest2-file Path to second (newer) manifest XML
--output-file Output path; format by extension: .json, .txt, .xlsx

Basic usage

Use the bundled config.json in this skill directory (or pass your own):

diffmanifests \
  --config-file config.json \
  --manifest1-file path/to/older.xml \
  --manifest2-file path/to/newer.xml \
  --output-file path/to/output.json

From inside the skill directory: --config-file config.json.

Output format is chosen by --output-file extension: .json (structured), .txt (plain text), .xlsx (Excel).

Output (JSON)

Each change entry can include: author, branch, change, commit, committer, date, diff (e.g. ADD COMMIT / REMOVE COMMIT), hashtags, message, repo, topic, url.

When to use

  • User asks to compare two manifest files or manifest versions.
  • User mentions diffmanifests, Gerrit manifest diff, or Gitiles manifest comparison.
  • Task involves Android/repo manifest version analysis or change reports.
Usage Guidance
This skill is internally consistent for comparing manifest XMLs via Gerrit/Gitiles. Before installing or running it: 1) Inspect the PyPI package (diffmanifests) on PyPI/GitHub to confirm the code does what you expect — don't blindly run `pip install`. 2) Provide credentials only if needed and prefer limited-scope tokens/accounts. 3) Run the tool in an isolated environment (container/VM) if you have concerns about installing third-party packages. 4) If you need higher assurance, ask the skill author for the package source or vendor-signed release rather than installing blindly from the network.
Capability Analysis
Type: OpenClaw Skill Name: diffmanifests Version: 0.1.0 The diffmanifests skill is a legitimate utility for comparing Android repository manifest XML files using Gerrit and Gitiles APIs. The bundle includes standard documentation (SKILL.md), a metadata file, and a configuration template (config.json) with empty credential fields and official Android source URLs. No malicious code, data exfiltration, or prompt injection attempts were found.
Capability Assessment
Purpose & Capability
Name/description match the instructions: the skill directs use of a diffmanifests CLI that queries Gerrit/Gitiles and outputs JSON/txt/xlsx reports. The included config.json contains Gerrit and Gitiles endpoints and optional credentials, which is appropriate for the stated purpose.
Instruction Scope
SKILL.md confines actions to installing the diffmanifests CLI, reading a config JSON (bundled or user-supplied), reading two manifest XML files, and writing an output file. It does not instruct reading unrelated system files, environment variables, or exfiltrating data to unexpected endpoints beyond Gerrit/Gitiles.
Install Mechanism
There is no install spec in the skill bundle; instead the instructions tell the agent to run `pip install diffmanifests`. Installing a package from PyPI at runtime is a normal choice but is a moderate-risk operation because it pulls third-party code to disk and executes it. The skill itself does not include the package code to review.
Credentials
No environment variables or system config paths are requested by the skill. The config.json exposes fields for Gerrit/Gitiles user and pass (username/token), which are expected and proportionate to contacting those services.
Persistence & Privilege
The skill does not request persistent or elevated platform privileges, is not always-enabled, and does not modify other skills or global agent configuration. Autonomous invocation is allowed but is the platform default and not excessive here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install diffmanifests
  3. After installation, invoke the skill by name or use /diffmanifests
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of diffmanifests. - Compare two manifest XML files using Gerrit and Gitiles APIs. - Generate detailed reports in JSON, plain text, or Excel format. - Configure with a JSON file (sample included). - All four CLI arguments are required: config file, two manifests, and output file. - Designed for Android or repo manifest version comparisons and change reporting.
Metadata
Slug diffmanifests
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is diffmanifests?

Compare manifest XML files via Gerrit and Gitiles APIs, producing JSON/txt/xlsx reports. Use when comparing Android or repo manifest versions, diffing manife... It is an AI Agent Skill for Claude Code / OpenClaw, with 269 downloads so far.

How do I install diffmanifests?

Run "/install diffmanifests" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is diffmanifests free?

Yes, diffmanifests is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does diffmanifests support?

diffmanifests is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created diffmanifests?

It is built and maintained by Jia (@craftslab); the current version is v0.1.0.

💬 Comments