skills.rest
Arasz
AraszCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

den-refresh

Detects framework drift and re-scaffolds an existing ai-badger project from its config.

2|Updated Jul 18, 2026
Search Tags:#drift detection#scaffolding#claude code#configuration management#framework update#ai-badger#project refresh
One-click install
npx skills add https://github.com/Arasz/ai-badger --skill den-refresh-arasz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: den-refresh
Source: https://github.com/Arasz/ai-badger/tree/main/features/common/skills/den-refresh
Command: npx skills add https://github.com/Arasz/ai-badger --skill den-refresh-arasz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jsonschema, and includes scripts (resource) and references (resource) components.

What problem does it solve? Projects scaffolded by ai-badger fall behind the framework as new versions ship, and nobody knows what changed or whether local edits will be overwritten. This Skill reports exactly what drifted, backs up .ai-badger/, and re-scaffolds from the project's existing config.json without re-asking setup questions. ## Core Features & Use Cases - Drift detection and reporting: Compares the project's manifest against the framework's current content and reports changed, removed, orphaned, locally modified, and newly added catalog items as structured JSON. - Safe re-scaffolding: Backs up .ai-badger/ before rewriting managed files, preserves seed-once files (state.json, markers-context.json, model.json) and content inside keep-region markers, and re-embeds skill extensions automatically. - Hygiene reporting: Surfaces competing framework copies, unused delivered skills with usage evidence windows, and orphaned Hermes skill namespaces — pruning only on explicit user approval. - Use Case: A drift notice appears after ai-badger 0.60.0 ships. Run the refresh to see which skills changed upstream, review the git diff of regenerated CLAUDE.md and AGENTS.md files, and commit the updates. ## Quick Start Ask the agent to refresh ai-badger in this project and show what changed before committing.

Frequently Asked Questions about den-refresh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update ai-badger in an already-scaffolded project?▼

Run the den-refresh skill, which executes refresh.py against your project root. It detects drift against the current framework, backs up .ai-badger/, re-scaffolds using your existing config.json, and prints a JSON report of everything that changed.

What is the difference between welcome-ai-badger and den-refresh?▼

welcome-ai-badger handles first-time setup: stack detection, config authoring, and plugin installation. den-refresh handles subsequent updates only — it reads the existing config.json, asks no questions, and re-scaffolds from the manifest's skill list.

Will a refresh overwrite my custom edits to CLAUDE.md or AGENTS.md?▼

Managed agent files are regenerated in full, so project-authored content is dropped unless it sits between ai-badger:keep-start and ai-badger:keep-end markers. Seed-once files like state.json and model.json are always preserved.

How do I permanently remove a skill ai-badger keeps delivering?▼

Add the skill name to the exclude.skills array in .ai-badger/config.json and re-run the refresh. Deleting the files alone does not work — absence is not a declaration, and the next refresh restores them.

Why does refresh.py exit with code 2?▼

Exit code 2 means a usage error: missing config.json or manifest.json, or a config that fails schema validation. The JSON output includes an error field and validationErrors array; fix the config, then re-run.

Does den-refresh delete anything automatically?▼

No. Pruning the ~/.ai-badger/framework cache requires --prune-cache, and removing orphaned Hermes skill namespaces requires --prune-namespaces after explicit user approval. By default it only reports and deletes nothing.

Related Skills

Explore More Software Engineering Skills→
ultraviollettnymphoultraviollettnympho
1

github-copilot-starter

Generates complete GitHub Copilot configuration files for a project's technology stack.

Community
Intermediate
AbsolutSystemsAbsolutSystems
1

ship

Generate commit messages and pull request descriptions from feature pipeline artifacts.

Official
Advanced
lapaixkemsdortshlee-svglapaixkemsdortshlee-svg

subagent-driven-development

Delegate independent implementation tasks to fresh subagents with per-task review and branch-wide quality gates.

Community
Advanced
kamelmhkamelmh

init-project

Initialize or refresh OpenCode JOC projects with .opencode/ scaffolding and AGENTS.md generation.

Community
Advanced