Skip to main content
skill CX Codex

knowledge-refresh — Claude Code skill: what it does, how to install

knowledge-refresh — a Claude Code skill that checks project knowledge against code and data after a release. It proposes fixes for stale or inaccurate files.

MIT ★ 106 updated 2026-11-06

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add DataWithBaraa/claude-code-data-engineering-skills
/plugin install data-engineering@data-with-baraa
Open on GitHub

What knowledge-refresh does

knowledge-refresh checks whether project knowledge matches the current code and data. After a release, it compares CLAUDE.md, standards, source pages, the glossary, documents, architecture, the core model, known issues, and incident records. Run it with an area to inspect or without an argument.

For each finding, the skill names the file, summarizes its current claim, states what is true, and proposes a change. It also flags unread documents and trims repeated material while linking to the file that keeps it. Changes are written only after approval from the data engineer, and only to knowledge files; runbooks and how-to guides belong to a separate docs skill.

What it helps with

  • find stale paths in CLAUDE.md
  • compare project standards with the code
  • check source contracts against their files
  • prepare knowledge-file updates after a release

Example prompts for the agent

  • After the release, check which project notes are out of date.
  • Compare the architecture and standards with the code in models.
  • Review the incident log and propose updates to the knowledge files.

How to install knowledge-refresh

1Plugin marketplace

/plugin marketplace add DataWithBaraa/claude-code-data-engineering-skills
/plugin install data-engineering@data-with-baraa

This installs the whole data-engineering plugin with all its skills

2Skills CLI (Vercel)

npx skills add DataWithBaraa/claude-code-data-engineering-skills --skill knowledge-refresh -a claude-code

3Manually: put the files in place

~/.claude/skills/knowledge-refresh/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/knowledge-refresh/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about knowledge-refresh

How do I install knowledge-refresh in Claude Code?

Add the marketplace with /plugin marketplace add DataWithBaraa/claude-code-data-engineering-skills, then install the plugin with /plugin install data-engineering@data-with-baraa.

What does knowledge-refresh do?

After a release, it compares project knowledge and documents with the code and data, then lists proposed fixes for mismatches. It writes approved changes only after the data engineer agrees.

Can knowledge-refresh change files without approval?

No. It presents proposed changes first and writes to knowledge files only after approval.

Source text

SKILL.md · MIT
---
name: knowledge-refresh
description: Use after a release, to compare the knowledge Claude Code reads, CLAUDE.md, the standards, the source pages and the incident log, with the code and the data, and propose what is stale, missing or wrong.
argument-hint: "[area]"
---

# Knowledge refresh

The job: keep the knowledge that Claude Code reads true to the project: CLAUDE.md and the knowledge folder. It proposes, and after the data engineer's yes it writes the approved changes. The runbook and the how-to guides belong to the docs skill.

Input: none, or the area to check.

## Steps

1. CLAUDE.md: every folder it names exists, every skill is listed, every path is right.
2. The standards against the code: naming, layers, code style.
3. The sources against the contracts and the files: one page per source, current.
4. The business: the glossary and the stakeholders against the documents.
5. The architecture and the core model against what is built.
6. The known issues and the incident log: what a run has proven since. The incident skill adds the entries, this skill checks them.
7. The decision log: what is decided, what is still open.
8. A document nobody has read yet: what it adds to the knowledge.
9. Keep it short: what repeats another file is cut and linked.
10. Report every finding as a proposal: the file, what it says, what is true.

## Output

A list of proposals, one per finding: the file, what it says, what is true, and the change. After the yes, the approved changes in the knowledge files.

## Reads

- the knowledge, the code, the data contracts, the documents, the run records

## Writes

- nothing until the yes, then only the knowledge files the data engineer approved

## Never

- Never applies a change without the yes.

© Data With Baraa · MIT · DataWithBaraa/claude-code-data-engineering-skills

Similar skills

SKILL.md skills catalog →

From the same set15

The whole set →
impact The impact Claude Code skill maps what depends on a table, column, or function. It gathers upstream sources, downstream consumers, checks, and a safe change order. CX Codex +1 ★ 106repo stars reconcile The reconcile Claude Code skill traces differences between figures in reports, queries, or tables. It narrows the gap to specific slices and explains the causes. CX Codex +1 ★ 106repo stars quality quality — a Claude Code skill that reports data checks and whether tables are safe to use. Give it a date or period to inspect failures, warnings, quarantined rows, and freshness. CX Codex +1 ★ 106repo stars incident The incident Claude Code skill traces a failed job run from its error toward a root cause. Give it a failure date or job and run; it produces an HTML page with a workaround, solution options and email drafts. CX Codex +1 ★ 106repo stars data-product Builds a data product page for people using a table. It runs when a table is released, changed, or served to consumers. CX Codex +1 ★ 106repo stars toolkit The toolkit Claude Code skill builds a project documentation site from the repository. It covers architecture, data lineage, code calls, quality checks, and runs. CX Codex +1 ★ 106repo stars migration Plans the move from legacy jobs and tables to a new platform. It lays out migration scenarios, acceptance criteria, a parallel run, and rollback. CX Codex +1 ★ 106repo stars metadata This Claude Code skill builds or extends metadata for a data source. It runs when table and column details need to be gathered from source files and documentation. CX Codex +1 ★ 106repo stars

Project sponsors

Companies that keep this analytics open