DOCX
rvdbreemen/OTGW-firmware
A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).
Analyze an Adaptive Cover Pro diagnostics JSON file and produce a triage report.
MITAuto-check passed
Install Acp Diagnose
$ npx skills add jrhubott/adaptive-cover-pro --skill acp-diagnose -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install jrhubott/adaptive-cover-pro acp-diagnose --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/jrhubott/adaptive-cover-pro.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/acp-diagnose .claude/skills/acp-diagnose && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "acp-diagnose" agent skill from https://github.com/jrhubott/adaptive-cover-pro/tree/main/.claude/skills/acp-diagnose into .claude/skills/acp-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "acp-diagnose", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/jrhubott/adaptive-cover-pro/tree/main/.claude/skills/acp-diagnoseType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add jrhubott/adaptive-cover-pro --skill acp-diagnose -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install jrhubott/adaptive-cover-pro acp-diagnose --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jrhubott/adaptive-cover-pro.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/acp-diagnose .agents/skills/acp-diagnose && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "acp-diagnose" agent skill from https://github.com/jrhubott/adaptive-cover-pro/tree/main/.claude/skills/acp-diagnose into .agents/skills/acp-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "acp-diagnose", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jrhubott/adaptive-cover-pro --skill acp-diagnose -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install jrhubott/adaptive-cover-pro acp-diagnose --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jrhubott/adaptive-cover-pro.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/acp-diagnose .cursor/skills/acp-diagnose && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "acp-diagnose" agent skill from https://github.com/jrhubott/adaptive-cover-pro/tree/main/.claude/skills/acp-diagnose into .cursor/skills/acp-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "acp-diagnose", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/jrhubott/adaptive-cover-pro.git --path .claude/skills/acp-diagnose--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add jrhubott/adaptive-cover-pro --skill acp-diagnose -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install jrhubott/adaptive-cover-pro acp-diagnose --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jrhubott/adaptive-cover-pro.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/acp-diagnose .gemini/skills/acp-diagnose && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "acp-diagnose" agent skill from https://github.com/jrhubott/adaptive-cover-pro/tree/main/.claude/skills/acp-diagnose into .gemini/skills/acp-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "acp-diagnose", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install jrhubott/adaptive-cover-pro acp-diagnoseInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add jrhubott/adaptive-cover-pro --skill acp-diagnose -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/jrhubott/adaptive-cover-pro.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/acp-diagnose .github/skills/acp-diagnose && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "acp-diagnose" agent skill from https://github.com/jrhubott/adaptive-cover-pro/tree/main/.claude/skills/acp-diagnose into .github/skills/acp-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "acp-diagnose", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jrhubott/adaptive-cover-pro --skill acp-diagnose -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install jrhubott/adaptive-cover-pro acp-diagnose --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jrhubott/adaptive-cover-pro.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/acp-diagnose .opencode/skills/acp-diagnose && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "acp-diagnose" agent skill from https://github.com/jrhubott/adaptive-cover-pro/tree/main/.claude/skills/acp-diagnose into .opencode/skills/acp-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "acp-diagnose", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
acp-diagnose- GitHub stars
- 176
- Token cost
- ~958 tokens
- SKILL.md length
- 479 words
- Files
- 1
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- MIT
At a glance
Analyze an Adaptive Cover Pro diagnostics JSON file and produce a triage report.
- Works in 3 steps: Run the engine. From the repo root, with… → Narrate each finding. For every line the… → Investigate anything the engine cannot…
- The user provides a diagnostics.json download from HA
- SKILL.md covers How to Execute, Offline seam — what the engine… and Output
- Calls python
What it does
Acp Diagnose is an agent skill from jrhubott/adaptive-cover-pro. Analyze an Adaptive Cover Pro diagnostics JSON file and produce a triage report. Use when the user provides a diagnostics.json download from HA, attaches a diagnostics file, or asks to diagnose an Adaptive Cover Pro issue. Trigger on phrases like "analyze diagnostics", "what does this diagnostics show", "why isn't my cover moving", paired with a JSON file.
Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It works with Home Assistant. The repository describes itself as: Adaptive sun-tracking cover control for Home Assistant: blinds, awnings, and venetian tilts with climate-aware positioning and a priority override pipeline. The licence is MIT.
When your agent uses it
- The user provides a diagnostics.json download from HA
- Attaches a diagnostics file
- Asks to diagnose an Adaptive Cover Pro issue
- Phrases like analyze diagnostics
Example prompts
- “analyze diagnostics”
- “what does this diagnostics show”
- “why isn”
- “/acp-diagnose”
Requirements
- Python 3
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Run the engine. From the repo root, with the dev virtualenv (the package import pulls Home Assistant, which is not on the system…
- Narrate each finding. For every line the engine printed, restate it in plain English for the user and include its wiki deep link (the…
- Investigate anything the engine cannot explain. If the user's symptom is not covered by any finding, read the relevant sections of the…
What it can do on your machine
Read from SKILL.md and the folder at commit c03d682. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
python
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Acp Diagnose loads about 958 tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 479 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from jrhubott/adaptive-cover-pro at commit c03d682, republished under its MIT licence (© jrhubott). 479 words, ~958 tokens.
Download SKILL.mdSave it as
.claude/skills/acp-diagnose/SKILL.md (or your agent's skills folder).- name
- acp-diagnose
- description
- Analyze an Adaptive Cover Pro diagnostics JSON file and produce a triage report. Use when the user provides a diagnostics.json download from HA, attaches a diagnostics file, or asks to diagnose an Adaptive Cover Pro issue. Trigger on phrases like "analyze diagnostics", "what does this diagnostics show", "why isn't my cover moving", paired with a JSON file.
ACP Diagnose
Analyze a diagnostics JSON file downloaded from Home Assistant (Settings → Devices & Services → Adaptive Cover Pro → ⋮ → Download diagnostics) by running the same declarative rules engine that powers the in-product Troubleshoot step, then narrating the findings.
The prose checklist this skill used to carry is gone: the checks now live in the TRIAGE_RULES table in custom_components/adaptive_cover_pro/diagnostics/triage.py, and scripts/triage_json.py runs them offline. The same table drives the in-product troubleshoot step AND this offline triage — so a gap in one is a gap in both, and closing it means adding a rule row, not editing this skill.
How to Execute
When the user provides a diagnostics JSON file (path or attachment):
Run the engine. From the repo root, with the dev virtualenv (the package import pulls Home Assistant, which is not on the system interpreter):
bash venv/bin/python scripts/triage_json.py <path-to-diagnostics.json>Add
--latest-version <X.Y.Z>when you know the newest release — it enables theSTALE_VERSIONcheck (offline it cannot fetch the latest release itself). Add--lang de/--lang frto render findings in German or French.Narrate each finding. For every line the engine printed, restate it in plain English for the user and include its wiki deep link (the script prints one per finding). Lead with the criticals (🛑), then warnings (⚠️), then info (ℹ️).
Investigate anything the engine cannot explain. If the user's symptom is not covered by any finding, read the relevant sections of the diagnostics JSON directly (
decision_trace,control_status,cover_commands,last_skipped_action,sun_validity,climate_conditions) and reason about it by hand.An unexplained symptom is a missing rule row. When you find yourself hand-explaining a class of problem the engine did not flag, that is the signal to add a rule — follow Developer Triage Rules (five edits: one rule row, one English template +
en.jsonleaf, one JSON leaf per language via theacp-translateskill, one test, one wiki section). Offer to file an issue or open that change.
If no file is provided, ask: "Please share the diagnostics JSON (download from HA: Settings → Devices & Services → Adaptive Cover Pro → ⋮ → Download diagnostics)."
Show full SKILL.md (145 more words)Show less
Offline seam — what the engine cannot see in a download
The diagnostics download carries neither per-entity capabilities nor the policy-derived axis requirements (both are built live inside the config flow), so two config rules cannot fire offline:
COVER_NOT_READY(rule 8a) — a cover reporting no capabilities. Its runtime twinENTITY_UNAVAILABLE(8b) does fire offline, readingcovers[*].available.COVER_FEATURE_MISMATCH(rule 13) — a cover missing an axis its type needs.
And STALE_VERSION (rule 24) fires only when you pass --latest-version. If a user's problem is a capability mismatch or an out-of-date install, check those by hand — the offline run will not raise them.
Output
Present the engine's findings as a short triage report: a one-line summary of the most likely cause and what to change, then the findings grouped by severity with their wiki links, then any hand-investigated notes for symptoms the engine did not cover. Keep it actionable.
© jrhubott, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .claude/skills/acp-diagnose of jrhubott/adaptive-cover-pro.
Open the folder on GitHubat commit c03d682
Compare with similar skills
Acp Diagnose next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Acp Diagnose this skilljrhubott/adaptive-cover-pro | 176 | — | ~958 | Automated safety check: Pass | MIT | |
| DOCXrvdbreemen/OTGW-firmware | 207 | 33 repos | ~4.3k | Automated safety check: Pass | Proprietary | |
| PPTXrvdbreemen/OTGW-firmware | 207 | 34 repos | ~2.3k | Automated safety check: Pass | Proprietary | |
| XLSXrvdbreemen/OTGW-firmware | 207 | 35 repos | ~2.9k | Automated safety check: Pass | Proprietary | |
| Sap Extension Creatorheshengtao/super-agent-party | 2.7k | — | ~6k | Automated safety check: Pass | AGPL-3.0 | |
| Ha Frontend Componentshome-assistant/frontend | 5.7k | — | ~1.2k | Automated safety check: Pass | Apache-2.0 |
Similar skills
PPTX
rvdbreemen/OTGW-firmware
Use this skill any time a .pptx file is involved in any way — as input, output, or both.
XLSX
rvdbreemen/OTGW-firmware
Use this skill any time a spreadsheet file is the primary input or output.
Sap Extension Creator
heshengtao/super-agent-party
Create Super Agent Party (SAP) extensions. An agent skill from heshengtao/super-agent-party.
Ha Frontend Components
home-assistant/frontend
Home Assistant frontend component patterns. An agent skill from home-assistant/frontend.
Ha Android Architecture
home-assistant/android
Home Assistant Android module and layer architecture. An agent skill from home-assistant/android.
More from jrhubott/adaptive-cover-pro
Acp Issue Diagnose
jrhubott/adaptive-cover-pro
Triage an Adaptive Cover Pro GitHub issue end-to-end — fetch the attached diagnostics file (or take a local path), run a Sonnet-powered diagnosis, and draft a reply ready to post on the issue.
Acp Live Diagnose
jrhubott/adaptive-cover-pro
Root-cause a misbehaving Adaptive Cover Pro cover on a RUNNING Home Assistant install by pulling live diagnostics over the HA MCP, correlating against the recorder, proving the mechanism with a…
Acp Translate
jrhubott/adaptive-cover-pro
Sync DE/FR translations with en.json, add a new language, drop a language, or check translation status for the Adaptive Cover Pro integration.
Related
Works with
Questions about Acp Diagnose
What does Acp Diagnose do?
Analyze an Adaptive Cover Pro diagnostics JSON file and produce a triage report. Acp Diagnose is an agent skill from jrhubott/adaptive-cover-pro. Analyze an Adaptive Cover Pro diagnostics JSON file and produce a triage report.
When should I use Acp Diagnose?
Acp Diagnose fits situations like: the user provides a diagnostics.json download from HA; attaches a diagnostics file; asks to diagnose an Adaptive Cover Pro issue; phrases like analyze diagnostics.
How do I install Acp Diagnose in Claude Code?
Run `npx skills add jrhubott/adaptive-cover-pro --skill acp-diagnose -a claude-code`. Or copy the skill folder (.claude/skills/acp-diagnose in jrhubott/adaptive-cover-pro) into .claude/skills/acp-diagnose in your project. Claude Code loads it when a task matches its description.
How do I install Acp Diagnose in Codex?
Run `npx skills add jrhubott/adaptive-cover-pro --skill acp-diagnose -a codex`. Or copy the skill folder (.claude/skills/acp-diagnose in jrhubott/adaptive-cover-pro) into .agents/skills/acp-diagnose in your project. Codex loads it when a task matches its description.
Can I use Acp Diagnose in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jrhubott/adaptive-cover-pro --skill acp-diagnose -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/acp-diagnose, .gemini/skills/acp-diagnose, .github/skills/acp-diagnose and .opencode/skills/acp-diagnose in your project.
What does Acp Diagnose need to run?
Going by SKILL.md and its folder, Acp Diagnose needs the command-line tools its instructions call (python). Our summary lists: Python 3.
Does Acp Diagnose access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Acp Diagnose safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Acp Diagnose use?
Acp Diagnose is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Acp Diagnose use?
About 958 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Acp Diagnose?
Skills that share tags, products or a category with Acp Diagnose: DOCX (rvdbreemen/OTGW-firmware, 207 stars), PPTX (rvdbreemen/OTGW-firmware, 207 stars), XLSX (rvdbreemen/OTGW-firmware, 207 stars) and Sap Extension Creator (heshengtao/super-agent-party, 2.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Acp Diagnose?
jrhubott (a GitHub user) maintains it in jrhubott/adaptive-cover-pro, which has 176 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 9, 2026.
Source: jrhubott/adaptive-cover-pro on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.