Agent skill

Improve Context

by ai-analyst-lab in ai-analyst-lab/ai-analyst

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.

MITAuto-check passed

Install Improve Context

skills CLI
$ npx skills add ai-analyst-lab/ai-analyst --skill improve-context -a claude-code

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

GitHub CLI
$ gh skill install ai-analyst-lab/ai-analyst improve-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/ai-analyst-lab/ai-analyst.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/improve-context .claude/skills/improve-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
improve-context
GitHub stars
304
Token cost
~753 tokens
SKILL.md length
371 words
Files
1
Skills in repo
43
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Works in 6 steps: Diagnose → Propose → Preserve the baseline → …
  • The user asks to improve context
  • SKILL.md covers 1. Diagnose, 2. Propose, 3. Preserve the baseline and 4. Apply one change, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Improve Context is an agent skill from ai-analyst-lab/ai-analyst. 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.

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: AI Product Analyst — Claude Code-powered data analysis toolkit. The licence is MIT.

When your agent uses it

  • The user asks to improve context
  • Fix a definition
  • Test whether context helped
  • Invokes /improve-context

Example prompts

  • “/improve-context”

Workflow steps

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

  1. Diagnose
  2. Propose
  3. Preserve the baseline
  4. Apply one change
  5. Rerun and inspect
  6. Write the receipt

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Improve Context loads about 753 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 371 words of instructions outside code blocks.

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

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 ai-analyst-lab/ai-analyst at commit 52c0744, republished under its MIT licence (© ai-analyst-lab). 371 words, ~753 tokens.

Download SKILL.mdSave it as .claude/skills/improve-context/SKILL.md (or your agent's skills folder).
name
improve-context
description
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.

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

Run the working and regression cases before the edit. Keep the manifest paths and run IDs. Freeze the suite, data snapshot, model, evaluator, and trial count. Record the proposal's target case IDs and use the installed suite agreed for this experiment. Do not silently replace it with a legacy policy fixture. Lock outputs before grading; keep evaluation references outside candidate context. Do not launch model runs if the user has paused them.

Show full SKILL.md (153 more words)Show less

4. Apply one change

Make only the approved context change. Show the diff. Do not change the evaluator or expected results in the same comparison.

5. Rerun and inspect

Run the same working and regression cases. Inspect:

  • aggregate score;
  • target cases;
  • regressions;
  • cases still failing;
  • context manifest;
  • context citations and SQL-use evidence.

6. Write the receipt

Use helpers.knowledge.context_change with the baseline and candidate manifests. Pass every named target with --target-case, and verify that the actual changed system paths are a subset of the approved changed paths. The receipt must recommend:

  • accept when target cases improve, no passing case regresses, and the comparison is controlled;
  • revert when a passing case regresses without an understood exception;
  • revise when the runs are not comparable or the change does not improve the target behavior.

The user chooses whether to promote the proposal. The system may draft the change and evidence, but it does not ratify business truth.

© ai-analyst-lab, 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/improve-context of ai-analyst-lab/ai-analyst.

Open the folder on GitHubat commit 52c0744

Compare with similar skills

Improve 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.

Improve Context compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Improve Context this skillai-analyst-lab/ai-analyst304—~753Automated safety check: PassMIT
Diagnose Playwright Failure as Product Bugappsmithorg/appsmith41k—~1.5kAutomated safety check: PassApache-2.0
Diagnose Gatewayopenclaw/openclaw392k—~670Automated safety check: PassMIT
Analytics Trackingalirezarezvani/claude-skills28k1 repos~3.8kAutomated safety check: PassMIT
Analyticsgetsentry/sentry46k—~2.5kAutomated safety check: PassCustom licence
Geo Proposalsickn33/agentic-awesome-skills47k1 repos~3.2kAutomated safety check: NotesMIT

Similar skills

  • Investigates a stubbornly failing Playwright test as a possible product bug, using error output, screenshots, traces and server code, and writes a structured bug report.

    41k GitHub stars~1.5k tokensUpdated today
    Testing & QAAuto-check passed
  • Diagnose Gateway

    openclaw/openclaw

    Diagnose Gateway, config, secrets, channels, and port failures with read-only one-liners.

    392k GitHub stars~670 tokensUpdated today
    Auto-check passed
  • Analytics Tracking

    alirezarezvani/claude-skills

    Set up, audit, and debug analytics tracking implementation — GA4, Google Tag Manager, event taxonomy, conversion tracking, and data quality.

    28k GitHub starsUsed in 1 repo~3.8k tokens
    Data & AnalyticsAuto-check passed
  • Analytics

    getsentry/sentry

    Official

    Instrument and discover analytics events in Sentry's frontend UI.

    46k GitHub stars~2.5k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Geo Proposal

    sickn33/agentic-awesome-skills

    Auto-generate a professional, client-ready GEO service proposal from audit data.

    47k GitHub starsUsed in 1 repo~3.2k tokens
    Sales & SupportAuto-check: notes
  • Better Proposals Automation

    ComposioHQ/awesome-claude-skills

    Automate Better Proposals tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~764 tokens
    Productivity & AutomationAuto-check passed

More from ai-analyst-lab/ai-analyst

All 43 skills in this repo
  • Always Compare

    ai-analyst-lab/ai-analyst

    Never present a metric or number in isolation; anchor every number to a comparison (prior period, benchmark, or another segment) or state that none is available.

    304 GitHub stars~1.4k tokensUpdated 7 days ago
    Auto-check passed
  • Archaeology

    ai-analyst-lab/ai-analyst

    Retrieve proven SQL patterns, table cheatsheets, and join patterns from .knowledge/query-archaeology/ so past work gets reused.

    304 GitHub stars~1.3k tokensUpdated 7 days ago
    Auto-check passed
  • Archive Analysis

    ai-analyst-lab/ai-analyst

    Save completed analyses to the knowledge system's analysis archive for future reference.

    304 GitHub stars~2.7k tokensUpdated 7 days ago
    Auto-check passed
  • Auth Preflight

    ai-analyst-lab/ai-analyst

    Verify Google Workspace MCP authentication at the start of any session that needs Google APIs (Docs, Slides, Drive).

    304 GitHub stars~3.1k tokensUpdated 7 days ago
    Auto-check passed
  • Causal

    ai-analyst-lab/ai-analyst

    Causal inference toolkit for when experiments are not possible: estimate treatment effects from observational data with assumption checks and mandatory caveats.

    304 GitHub stars~1.8k tokensUpdated 7 days ago
    Auto-check passed
  • Chart To Drive

    ai-analyst-lab/ai-analyst

    Standardized workflow for uploading local chart PNGs to Google Drive and making them available for insertion into Google Docs and Slides.

    304 GitHub stars~1.4k tokensUpdated 7 days ago
    Auto-check passed

Questions about Improve Context

What does Improve Context do?

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. Improve Context is an agent skill from ai-analyst-lab/ai-analyst. 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.

When should I use Improve Context?

Improve Context fits situations like: the user asks to improve context; fix a definition; test whether context helped; invokes /improve-context.

How do I install Improve Context in Claude Code?

Run `npx skills add ai-analyst-lab/ai-analyst --skill improve-context -a claude-code`. Or copy the skill folder (.claude/skills/improve-context in ai-analyst-lab/ai-analyst) into .claude/skills/improve-context in your project. Claude Code loads it when a task matches its description.

How do I install Improve Context in Codex?

Run `npx skills add ai-analyst-lab/ai-analyst --skill improve-context -a codex`. Or copy the skill folder (.claude/skills/improve-context in ai-analyst-lab/ai-analyst) into .agents/skills/improve-context in your project. Codex loads it when a task matches its description.

Can I use Improve 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 ai-analyst-lab/ai-analyst --skill improve-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/improve-context, .gemini/skills/improve-context, .github/skills/improve-context and .opencode/skills/improve-context in your project.

What does Improve Context need to run?

SKILL.md names no scripts, command-line tools or credentials: Improve Context is instructions for the agent only.

Does Improve 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 Improve 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. Review the folder before installing.

What licence does Improve Context use?

Improve Context 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 Improve Context use?

About 753 tokens (SKILL.md is roughly 3k 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 Improve Context?

Skills that share tags, products or a category with Improve Context: Diagnose Playwright Failure as Product Bug (appsmithorg/appsmith, 41k stars), Diagnose Gateway (openclaw/openclaw, 392k stars), Analytics Tracking (alirezarezvani/claude-skills, 28k stars) and Analytics (getsentry/sentry, 46k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Improve Context?

ai-analyst-lab (a GitHub organization) maintains it in ai-analyst-lab/ai-analyst, which has 304 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on September 30, 2026.

Source: ai-analyst-lab/ai-analyst on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.