Agent skill

Reconcile Context

by Apocrathia in Apocrathia/home-assistant-config

Fix drift in Home Assistant Homelab agent context (AGENTS.md, CLAUDE.md, .agents/context/, rules, skills, agents) against the repo.

No licenceAuto-check passedAgent Workflows

Install Reconcile Context

skills CLI
$ npx skills add Apocrathia/home-assistant-config --skill reconcile-context -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Apocrathia/home-assistant-config reconcile-context --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Apocrathia/home-assistant-config.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/reconcile-context .claude/skills/reconcile-context && rm -rf skills-src

Use ~/.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/

Facts

Skill name
reconcile-context
GitHub stars
179
Token cost
~931 tokens
SKILL.md length
307 words
Files
5 (incl. scripts)
Skills in repo
22
Repo updated
First seen
Licence
None found

At a glance

Fix drift in Home Assistant Homelab agent context (AGENTS.md, CLAUDE.md, .agents/context/, rules, skills, agents) against the repo.

  • Works in 4 steps: Deterministic checks → Structural drift → Reality drift → …
  • Update agent context
  • SKILL.md covers Workflow and Report
  • Runs Python scripts from its folder; calls python3

What it does

Reconcile Context is an agent skill from Apocrathia/home-assistant-config. Fix drift in Home Assistant Homelab agent context (AGENTS.md, CLAUDE.md, .agents/context/, rules, skills, agents) against the repo. Run checklinks and checkdiscovery. Use when asked to sync, reconcile, or update agent context.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `scripts/check_discovery.py`, `scripts/check_links.py` and `scripts/test_check_discovery.py`).

It sits in Agent Workflows, covering Agent instruction files and Codebase knowledge for agents. It works with Home Assistant and Git. The repository describes itself as: Apocrathia's Home Assistant Configuration Files.

When your agent uses it

  • Update agent context
  • Tasks that involve Agent instruction files
  • Tasks that involve Codebase knowledge for agents

Example prompts

  • “/reconcile-context”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Deterministic checks
  2. Structural drift
  3. Reality drift
  4. Drift notes

What it can do on your machine

Read from SKILL.md and the folder at commit e28308a. 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

    Ships 4 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Reconcile Context loads about 931 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 307 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~931

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 307 words (~931 tokens).

“Keep the agent context true and thin. Stale context is worse than none.”

— opening of SKILL.md by Apocrathia
name
reconcile-context
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (scripts) in .agents/skills/reconcile-context of Apocrathia/home-assistant-config.

  • SKILL.md
  • scripts/check_discovery.py
  • scripts/check_links.py
  • scripts/test_check_discovery.py
  • scripts/test_check_links.py

Open the folder on GitHubat commit e28308a

Compare with similar skills

Reconcile Context 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.

Reconcile Context compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reconcile Context this skillApocrathia/home-assistant-config179—~931Automated safety check: PassNone
Verify Agent ContextLuligu/matterbridge985—~525Automated safety check: PassApache-2.0
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Context Engineeringabashev/vfs-s31069 repos~2.6kAutomated safety check: NotesApache-2.0
Harness Evolution Feedback Looprevfactory/harness9.1k—~855Automated safety check: PassApache-2.0
Repo Context Ledgergviiisen/repo-context-ledger105—~2.8kAutomated safety check: PassMIT

Similar skills

  • Verify Agent Context

    Luligu/matterbridge

    Verify which coding agent is running and that it loaded the shared Matterbridge instructions, rules and skills from AGENTS.md and .agents/.

    985 GitHub stars~525 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed
  • Context Engineering

    abashev/vfs-s3

    Optimizes agent context setup. An agent skill from abashev/vfs-s3.

    106 GitHub starsUsed in 9 repos~2.6k tokens
    Agent WorkflowsAuto-check: notes
  • Collects feedback on how an agent harness performed, generalizes it, and updates the harness agents, skills and orchestrator along with a change-history table.

    9.1k GitHub stars~855 tokensUpdated 11 days ago
    Agent WorkflowsAuto-check passed
  • Repo Context Ledger

    gviiisen/repo-context-ledger

    Record every behavior-changing feature addition, fix, and adjustment as durable, evidence-based repository knowledge, then use that ledger to continue accurately across AI windows, tools, Git…

    105 GitHub stars~2.8k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Setup Matt Pocock Skills

    ywwynm/EverythingDone

    Sets up an Agent skills block in AGENTS.md/CLAUDE.md and docs/agents/ so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc…

    144 GitHub starsUsed in 9 repos~1.7k tokens
    Agent WorkflowsAuto-check passed

More from Apocrathia/home-assistant-config

All 22 skills in this repo
  • Alignment

    Apocrathia/home-assistant-config

    Interview the operator about a topic until shared understanding, walking each branch of the decision tree one at a time.

    179 GitHub stars~1.4k tokensUpdated 17 days ago
    Auto-check passed
  • Architecture Review

    Apocrathia/home-assistant-config

    Explore packages/, layout, and .agents/ for architectural friction (coupling, shallow packages, missing boundaries) and file or recommend agent issues under docs/issues/.

    179 GitHub stars~764 tokensUpdated 17 days ago
    Auto-check passed
  • Automation Debug

    Apocrathia/home-assistant-config

    Systematically diagnose and fix broken Home Assistant automations with a structured reproduce → triggers → conditions → actions workflow.

    179 GitHub stars~1.2k tokensUpdated 17 days ago
    Auto-check passed
  • Config Validate

    Apocrathia/home-assistant-config

    Validate Home Assistant YAML configuration for syntax, structure, entity references, duplicates, and secrets usage before applying changes.

    179 GitHub stars~932 tokensUpdated 17 days ago
    Auto-check passed
  • Create Agent

    Apocrathia/home-assistant-config

    Create a new agent persona under .agents/agents/. An agent skill from Apocrathia/home-assistant-config.

    179 GitHub stars~1.1k tokensUpdated 17 days ago
    Auto-check passed
  • Create Skill

    Apocrathia/home-assistant-config

    Create a new skill under .agents/skills/. An agent skill from Apocrathia/home-assistant-config.

    179 GitHub stars~1k tokensUpdated 17 days ago
    Auto-check passed

Categories

Questions about Reconcile Context

What does Reconcile Context do?

Fix drift in Home Assistant Homelab agent context (AGENTS.md, CLAUDE.md, .agents/context/, rules, skills, agents) against the repo. Reconcile Context is an agent skill from Apocrathia/home-assistant-config.agents/context/, rules, skills, agents) against the repo.

When should I use Reconcile Context?

Reconcile Context fits situations like: update agent context; tasks that involve Agent instruction files; tasks that involve Codebase knowledge for agents.

How do I install Reconcile Context in Claude Code?

Run `npx skills add Apocrathia/home-assistant-config --skill reconcile-context -a claude-code`. Or copy the skill folder (.agents/skills/reconcile-context in Apocrathia/home-assistant-config) into .claude/skills/reconcile-context in your project. Claude Code loads it when a task matches its description.

How do I install Reconcile Context in Codex?

Run `npx skills add Apocrathia/home-assistant-config --skill reconcile-context -a codex`. Or copy the skill folder (.agents/skills/reconcile-context in Apocrathia/home-assistant-config) into .agents/skills/reconcile-context in your project. Codex loads it when a task matches its description.

Can I use Reconcile Context 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 Apocrathia/home-assistant-config --skill reconcile-context -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reconcile-context, .gemini/skills/reconcile-context, .github/skills/reconcile-context and .opencode/skills/reconcile-context in your project.

What does Reconcile Context need to run?

Going by SKILL.md and its folder, Reconcile Context needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Reconcile Context 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 Reconcile Context 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Reconcile Context use?

No licence was found for Reconcile Context or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Reconcile Context use?

About 931 tokens (SKILL.md is roughly 3.7k 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 Reconcile Context?

Skills that share tags, products or a category with Reconcile Context: Verify Agent Context (Luligu/matterbridge, 985 stars), Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars), Context Engineering (abashev/vfs-s3, 106 stars) and Harness Evolution Feedback Loop (revfactory/harness, 9.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reconcile Context?

Apocrathia (a GitHub user) maintains it in Apocrathia/home-assistant-config, which has 179 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on September 21, 2026.

Source: Apocrathia/home-assistant-config on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.