Agent skill

Context Engineering Advisor

by deanpeters in deanpeters/Product-Manager-Skills

Diagnoses whether an AI workflow suffers from context stuffing or uses context engineering, and suggests structural fixes such as bounded domains and episodic retrieval.

Custom licenceAuto-check passedAgent Workflows

Install Context Engineering Advisor

skills CLI
$ npx skills add deanpeters/Product-Manager-Skills --skill context-engineering-advisor -a claude-code

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

GitHub CLI
$ gh skill install deanpeters/Product-Manager-Skills context-engineering-advisor --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/deanpeters/Product-Manager-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/context-engineering-advisor .claude/skills/context-engineering-advisor && 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
context-engineering-advisor
GitHub stars
7.2k
Used in
1 other repo
Token cost
~8.1k tokens
SKILL.md length
3,854 words
Files
1
Skills in repo
75
Repo updated
First seen
Licence
Custom licence

At a glance

Diagnoses whether an AI workflow suffers from context stuffing or uses context engineering, and suggests structural fixes such as bounded domains and episodic retrieval.

  • Works in 12 steps: Gather Context → Diagnose Context Stuffing Symptoms → Diagnostic Question 1 — What Specific… → …
  • An AI workflow has grown bloated, brittle or hard to steer reliably
  • SKILL.md covers Purpose, Input, Key Concepts and Application, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Written for product managers, the skill contrasts context stuffing, which assumes more volume means better output, as in pasting the entire PRD, with context engineering, which treats AI attention as a scarce resource and allocates it deliberately. It treats the problem as information architecture rather than prompt writing, and notes that a model's parametric knowledge is static and cannot be attributed, so grounding in current data is what closes the gap.

You describe the workflow, agent or prompt setup that feels bloated, brittle or hard to steer, plus what you have stuffed into context and where outputs go wrong. The advisor identifies context boundaries, addresses what it calls Context Hoarding Disorder, and recommends practices such as bounded context per agent, retrieval with intent instead of persisting everything, fixing structure instead of retrying, and the Research, Plan, Reset, Implement cycle.

When your agent uses it

  • An AI workflow has grown bloated, brittle or hard to steer reliably
  • Deciding what belongs in an agent's context and what should be retrieved on demand
  • Splitting a long agent chain into bounded contexts per agent

Example prompts

  • “Diagnose my setup: our support-triage agent gets the full 40-page policy manual per ticket and still misroutes edge cases.”
  • “My prompt keeps growing with every failure, so help me restructure the context.”
  • “How should I bound context between the research agent and the writing agent?”

Workflow steps

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

  1. Gather Context
  2. Diagnose Context Stuffing Symptoms
  3. Diagnostic Question 1 — What Specific Decision Does This Support?
  4. Diagnostic Question 2 — Can Retrieval Replace Persistence?
  5. Diagnostic Question 3 — Who Owns the Context Boundary?
  6. Diagnostic Question 4 — What Fails if We Exclude This?
  7. Diagnostic Question 5 — Are We Fixing Structure or Avoiding It?
  8. Define Memory Architecture
  9. Implement Research → Plan → Reset → Implement Cycle
  10. Action Plan & Next Steps
  11. "Infinite Context" Marketing vs. Engineering Reality
  12. Retrying Instead of Restructuring

What it can do on your machine

Read from SKILL.md and the folder at commit 1b5a524. 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 (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • deanpeters.substack.com
    • anthropic.com

    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

Context Engineering Advisor loads about 8.1k tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 3,854 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 3,854 words (~8,088 tokens).

“Guide product managers through diagnosing whether they're doing context stuffing (jamming volume without intent) or context engineering (shaping structure for attention). Use this to identify context boundaries, fix "Context Hoarding Disorder," and implement tactical practices like bounded domains, episodic retrieval…”

— opening of SKILL.md by deanpeters, Custom licence
name
context-engineering-advisor
argument-hint
[AI workflow to diagnose]
intent
Guide product managers through diagnosing whether they're doing **context stuffing** (jamming volume without intent) or **context engineering** (shaping…
type
interactive
theme
ai-agents
best_for
Diagnosing context stuffing vs. context engineering in your AI workflows, Building better memory and retrieval architecture for AI agents, Improving AI output…
scenarios
My AI outputs are mediocre even though I'm giving it lots of information — diagnose what's wrong, I want to architect context properly for a multi-step AI…
estimated_time
15-20 min

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/context-engineering-advisor of deanpeters/Product-Manager-Skills.

Open the folder on GitHubat commit 1b5a524

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in deanpeters/Product-Manager-Skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Context Engineering Advisor 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.

Context Engineering Advisor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Context Engineering Advisor this skilldeanpeters/Product-Manager-Skills7.2k1 repos~8.1kAutomated safety check: PassCustom licence
Badstephenleo/bmad-autonomous-development107—~7.7kAutomated safety check: PassMIT
GSD Phase Discussionopen-gsd/gsd-core10k1 repos~1.5kAutomated safety check: WarnMIT
Sagawarpdotdev/common-skills608—~4.1kAutomated safety check: PassMIT
Context Mode Output Sandboxmksglu/context-mode26k—~4.1kAutomated safety check: PassCustom licence
Memori Long-Term MemoryMemoriLabs/Memori17k—~2kAutomated safety check: NotesCustom licence

Similar skills

  • Bad

    stephenleo/bmad-autonomous-development

    BMad Autonomous Development — orchestrates parallel story implementation pipelines.

    107 GitHub stars~7.7k tokensUpdated 5 mo ago
    Agent WorkflowsAuto-check passed
  • GSD Phase Discussion

    open-gsd/gsd-core

    Asks adaptive questions about a project phase and records the decisions in a CONTEXT.md that later research and planning agents can act on without asking again.

    10k GitHub starsUsed in 1 repo~1.5k tokens
    Agent WorkflowsAuto-check: warnings
  • Saga

    warpdotdev/common-skills

    Run an autonomous, spec-driven development "saga" for medium-to-large features using an orchestrator agent and a fleet of worker subagents.

    608 GitHub stars~4.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Memori Long-Term Memory

    MemoriLabs/Memori

    Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

    17k GitHub stars~2k tokensUpdated 5 days ago
    Agent WorkflowsAuto-check: notes
  • Picoclaw Skill Creator

    sipeed/picoclaw

    Guidance for creating, updating and reviewing Picoclaw skills, from the SKILL.md structure to organizing bundled scripts, references and assets.

    30k GitHub stars~4.4k tokensUpdated 14 days ago
    Agent WorkflowsAuto-check passed

More from deanpeters/Product-Manager-Skills

All 75 skills in this repo
  • User Story Writer

    deanpeters/Product-Manager-Skills

    Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.

    7.2k GitHub starsUsed in 2 repos~2.9k tokens
    Auto-check passed
  • TAM SAM SOM Calculator

    deanpeters/Product-Manager-Skills

    Calculates total, serviceable available and serviceable obtainable market size for a product idea with explicit assumptions, methods and caveats.

    7.2k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Company Research Brief

    deanpeters/Product-Manager-Skills

    Builds a company research brief covering executive quotes, product strategy, transformation efforts and org context, tailored to interview prep, competitor or partnership work.

    7.2k GitHub starsUsed in 2 repos~3.8k tokens
    Auto-check passed
  • Organic Growth Path Advisor

    deanpeters/Product-Manager-Skills

    Diagnoses where a growth constraint lives and recommends one organic growth path from the McKinsey Growth Pyramid to test first.

    7.2k GitHub starsUsed in 2 repos~5.2k tokens
    Auto-check passed
  • PESTEL Macro Analysis

    deanpeters/Product-Manager-Skills

    Scans political, economic, social, technological, environmental, and legal forces that could threaten or favor a product strategy.

    7.2k GitHub starsUsed in 2 repos~3.6k tokens
    Auto-check passed
  • Prioritization Framework Advisor

    deanpeters/Product-Manager-Skills

    Picks the right prioritization framework for your stage and context instead of defaulting to RICE or ICE out of habit.

    7.2k GitHub starsUsed in 2 repos~4.2k tokens
    Auto-check passed

Questions about Context Engineering Advisor

What does Context Engineering Advisor do?

Diagnoses whether an AI workflow suffers from context stuffing or uses context engineering, and suggests structural fixes such as bounded domains and episodic retrieval. Written for product managers, the skill contrasts context stuffing, which assumes more volume means better output, as in pasting the entire PRD, with context engineering, which treats AI attention as a scarce resource and allocates it deliberately. It treats the problem as information architecture rather than prompt writing, and notes that a model's parametric knowledge is static and cannot be attributed, so grounding in current data is what closes the gap.

When should I use Context Engineering Advisor?

Context Engineering Advisor fits situations like: an AI workflow has grown bloated, brittle or hard to steer reliably; deciding what belongs in an agent's context and what should be retrieved on demand; splitting a long agent chain into bounded contexts per agent.

How do I install Context Engineering Advisor in Claude Code?

Run `npx skills add deanpeters/Product-Manager-Skills --skill context-engineering-advisor -a claude-code`. Or copy the skill folder (skills/context-engineering-advisor in deanpeters/Product-Manager-Skills) into .claude/skills/context-engineering-advisor in your project. Claude Code loads it when a task matches its description.

How do I install Context Engineering Advisor in Codex?

Run `npx skills add deanpeters/Product-Manager-Skills --skill context-engineering-advisor -a codex`. Or copy the skill folder (skills/context-engineering-advisor in deanpeters/Product-Manager-Skills) into .agents/skills/context-engineering-advisor in your project. Codex loads it when a task matches its description.

Can I use Context Engineering Advisor 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 deanpeters/Product-Manager-Skills --skill context-engineering-advisor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/context-engineering-advisor, .gemini/skills/context-engineering-advisor, .github/skills/context-engineering-advisor and .opencode/skills/context-engineering-advisor in your project.

What does Context Engineering Advisor need to run?

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

Does Context Engineering Advisor access the network?

SKILL.md names 2 domains. As links in the text: deanpeters.substack.com and anthropic.com. This is read from the text; nothing was executed.

Is Context Engineering Advisor 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 Context Engineering Advisor use?

Context Engineering Advisor has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Context Engineering Advisor use?

About 8.1k tokens (SKILL.md is roughly 32k 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 Context Engineering Advisor?

Skills that share tags, products or a category with Context Engineering Advisor: Bad (stephenleo/bmad-autonomous-development, 107 stars), GSD Phase Discussion (open-gsd/gsd-core, 10k stars), Saga (warpdotdev/common-skills, 608 stars) and Context Mode Output Sandbox (mksglu/context-mode, 26k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Context Engineering Advisor?

deanpeters (a GitHub user) maintains it in deanpeters/Product-Manager-Skills, which has 7,193 GitHub stars. The repository holds 75 skills in this directory. The repository was last updated on September 1, 2026.

Source: deanpeters/Product-Manager-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.