improve-context SKILL.md skillA

improve-context from ai-analyst-lab/ai-analyst is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ai-analyst-lab/ai-analyst/improve-context@git:20260930.0a47c0b

Pins git:20260930.0a47c0b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ai-analyst-lab/ai-analyst
Path
.claude/skills/improve-context/SKILL.md
Versions recorded
2
Latest version
git:20260930.0a47c0b, committed Sep 30, 2026
First version recorded
Sep 10, 2026
Size
3,009 bytes
Repository stars
322
License
MIT

Diagnose a context-related analytical failure, propose the smallest relevant change, compare the same evaluation cases before and after, and produce an accept, revise, or revert receipt. Use when the user asks to improve context, fix a definition or example, test whether context helped, or invokes /improve-context.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Improve context

Use the evaluation system as the referee. Do not promote a context change because the new answer looks more plausible.

## 1. Diagnose

Read the failing evaluation record and its analysis trace. Classify the context failure:

- missing information;
- wrong information;
- stale information;
- conflicting information;
- correct information was not supplied;
- supplied information was ignored or misapplied;
- the problem belongs in a skill, helper, workflow, or evaluator rather than context.

Run `/context-trace` on the exact question. Preserve its JSON fingerprint.

## 2. Propose

For edits to guides, reviewed queries or semantic definitions, use `/maintain-context`
to inspect the appropriate template, validate dependencies and preserve human review.

Create `working/context-change-proposal.yaml` with:

- observed failure and evidence;
- smallest proposed change;
- representation and delivery;
- source and owner;
- status `proposed`;
- cases expected to improve;
- possible regressions;
- required reviewers;
- acceptance criteria.

Do not change trusted context until the user approves the proposal.

## 3. Preserve the baseline
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ai-analyst-lab/ai-analyst/improve-context@sha256:421621773be147cc

The line at the top of this page pins the label git:20260930.0a47c0b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ey7r2pvl7py5xgvg.svg)](https://markdownregistry.com/a/art_ey7r2pvl7py5xgvg)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Sep 10, 2026 and Sep 30, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20260930.0a47c0b latest2026-09-30 0a47c0b 3,009 BA view · diff
git:20260910.c4b91ef2026-09-10 c4b91ef 2,792 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3009 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ai-analyst-lab/ai-analyst · 322 stars · license MIT · pushed 2026-09-30 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ey7r2pvl7py5xgvg
GET https://markdownregistry.com/api/v1/resolve?ref=ai-analyst-lab/ai-analyst/improve-context
GET https://markdownregistry.com/api/v1/blob/421621773be147ccd713a9a3e9c092ea2215870ec2bb9ff53cb78638e1b0c365

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ai-analyst-lab/ai-analyst

always-compare SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/always-compare/SKILL.md · Never present a metric or number in isolation; anchor every number to a comparison (prior period, benchmark, or another…
git:20260827.7ff2e25 · audit A · 322 stars
analysis-design SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/analysis-design/SKILL.md · Takes a vague analytical hunch, stakeholder request, or business question and produces a rigorous, stakeholder-ready…
git:20260902.b370de6 · audit A · 322 stars
analyst-core SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/analyst-core/SKILL.md · Operating rules for every data analysis. Apply for ANY data-analysis intent: "analyze", "investigate", "why did X…
git:20260930.0a47c0b · audit A · 322 stars
archaeology SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/archaeology/SKILL.md · Retrieve proven SQL patterns, table cheatsheets, and join patterns from .knowledge/query-archaeology/ so past work gets…
git:20260827.7ff2e25 · audit A · 322 stars
archive-analysis SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/archive-analysis/SKILL.md · Save completed analyses to the knowledge system's analysis archive for future reference. Use this skill after…
git:20260902.b370de6 · audit A · 322 stars
auth-preflight SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/auth-preflight/SKILL.md · Verify Google Workspace MCP authentication at the start of any session that needs Google APIs (Docs, Slides, Drive)…
git:20260902.b370de6 · audit A · 322 stars
business SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/business/SKILL.md · Browse, search, and explore your organization's business context system — glossary terms, product catalog, metric…
git:20260902.b370de6 · audit A · 322 stars
causal SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/causal/SKILL.md · Causal inference toolkit for when experiments are not possible: estimate treatment effects from observational data with…
git:20260828.01c26bc · audit A · 322 stars
chart-to-drive SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/chart-to-drive/SKILL.md · Standardized workflow for uploading local chart PNGs to Google Drive and making them available for insertion into…
git:20260827.7ff2e25 · audit A · 322 stars
close-the-loop SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/close-the-loop/SKILL.md · Ensure every analysis that includes a recommendation ends with a clear, actionable follow-up plan. CRITICAL RULE - Only…
git:20260902.b370de6 · audit A · 322 stars
codex-review SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/codex-review/SKILL.md · Independently validate the current analysis with a second model (OpenAI Codex). Codex re-derives the same answer from…
git:20260902.b370de6 · audit A · 322 stars
compare-datasets SKILL.md skill
ai-analyst-lab/ai-analyst · .claude/skills/compare-datasets/SKILL.md · Compare metrics, findings, and patterns across two or more connected datasets. Helps identify cross-dataset patterns…
git:20260902.b370de6 · audit A · 322 stars

Every file in ai-analyst-lab/ai-analyst

Browse by kind, by grade A, or by owner.