Dev & Engineering

Context Engineering

Helps coding agents load the right project context at the right time, reducing guesswork and convention drift.

49/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 107k
Last updated
13d ago
License
MIT
context-managementcoding-workflowrules-filesmcp-integration
+2requirements-clarificationverification

What does this skill do, and when should you use it?

Context Engineering is a context-management workflow for AI coding agents. It organizes rules files, specifications, source files, error output, and conversation history by persistence and task relevance. It also provides context-packing patterns, conflict handling, incomplete-requirement handling, lightweight planning, and verification checks. It fits development teams that want agents to follow project conventions, reduce hallucinated APIs, and regain focus when tasks change.

Guides an agent to create and maintain CLAUDE.md, AGENTS.md, or equivalent rules files; load specifications, relevant source files, tests, type definitions, and specific error output; structure context with Brain Dump, Selective Include, and Hierarchical Summary patterns; distinguish trusted source code from configuration, external documentation, and user content that needs verification; surface conflicts and incomplete requirements with explicit options; emit a lightweight plan for multi-step work; suggest MCP integrations such as Context7, Chrome DevTools, PostgreSQL, Filesystem, and GitHub; and finish with checks for rules coverage, real project references, and context refreshes.

Good fit
  • A developer starting a coding session who needs the agent to understand the stack, commands, conventions, and boundaries.
  • A team whose agent is inventing APIs, ignoring project patterns, or producing lower-quality output over time.
  • An engineer switching between areas of a large codebase who needs to load only the relevant specification and source files.
  • A team setting up a new project for AI-assisted development and needing persistent rules and a project map.
  • A developer facing a conflict between the specification and existing code, or an undefined behavior that should not be guessed.
  • A maintainer who wants a repeatable approach for feeding specific test failures or build errors back to the agent.

How do you install this skill?

Before you use it
  • This assessment is based only on the supplied source files; the skill, scripts, CI, and installation flow were not executed.
  • MCP integrations, external documentation, and configuration files may introduce data-leakage or prompt-injection risks; authorization scope and sources should be checked before use.
  • Repository-wide CI and evaluation evidence do not demonstrate the runtime effectiveness of context-engineering itself.
  • The publisher is not verified by the FollowSkills curated enterprise registry and is treated as unknown.
Before you start
Your agent needs
  • Local filesystem
  • MCP Server

This skill is distributed with the repository's 24-skill collection. Install the collection with the Skills CLI: npx skills add addyosmani/agent-skills. To browse first, use: npx skills add addyosmani/agent-skills --list. The README also provides a native Codex plugin command: codex plugin marketplace add addyosmani/agent-skills.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/addyosmani/agent-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/context-engineering" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • Use context engineering to prepare the project context before we modify the authentication module.

After installing the skill directory in an Agent Skills-compatible client, trigger context-engineering when starting a session, switching tasks, or when agent quality declines. Example: "Use context engineering to prepare the project context before we modify the authentication module." Ask the agent to read the files it will modify, related tests, and a similar existing pattern, and to pause when it finds a conflict or missing requirement.

What are this skill's strengths and limitations?

Pros
  • Defines a clear hierarchy and loading order for rules, specifications, source files, errors, and conversation history.
  • Provides reusable context-packing templates for keeping inputs focused and avoiding context flooding.
  • Explicitly requires ambiguity and incomplete requirements to be surfaced instead of silently guessed.
  • Includes trust-level guidance, anti-patterns, verification checks, and suggested MCP integrations.
Limitations
  • The skill is primarily instructional text; no script is shown that automatically creates rules files or loads context.
  • No test suite, runtime metrics, or effectiveness evaluation is provided for this individual skill.
  • MCP services are optional enrichment and depend on the client and environment configuration.
  • Rules filenames and client integration methods vary by tool and may require platform-specific setup.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Context Engineering this page 49 · Use with care ★ 107k 13d ago MIT
Hermes Ephemeral Delegation 49 · Use with care ★ 7.8k 12d ago MIT
Intent Interviewer 59 · Recommended ★ 107k 13d ago MIT
Handoff Plan 47 · Use with care ★ 64 10d ago MIT
e2e Playground Verification Skill 59 · Recommended ★ 10k 13d ago Apache-2.0

The README names Superpowers and Matt Pocock's skills as comparison points for the broader Agent Skills collection, but it gives no comparison specific to the context-engineering skill.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
49/ 100 5-point scale 2.5 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust15 / 25 · 3.0/5

The skill explicitly says not to commit .env files or secrets, to verify configuration and external documentation, and to treat instruction-like content as data; it also tells the agent to ask when requirements conflict or are incomplete. The deduction is for missing least-privilege guidance, explicit MCP/external data-flow disclosure, confirmation of external effects, dependency security review, and rollback procedures.

2Reliability8 / 20 · 2.0/5

The material is internally coherent and provides a context hierarchy, loading sequence, conflict handling, and verification checklist, making the happy path understandable. Points are deducted because abnormal cases such as unavailable tools, oversized context, or failed rules-file setup lack controlled, diagnosable error feedback; static calibration also caps this score at 10.

3Adaptability8 / 15 · 2.7/5

The audience is clear—AI coding agents—and the skill names concrete scenarios such as new sessions, task switching, and declining output quality, with examples for multiple rule-file formats and MCP services. Points are deducted because non-fit boundaries, precise semantic triggers, input/output contracts, and Chinese-language or mainland-China network fit are not adequately specified.

4Convention8 / 15 · 2.7/5

The documentation has clear layering with overview, use cases, procedures, anti-patterns, and verification examples; the repository README supplies installation guidance, and MIT licensing and a maintainer team are visible. Points are deducted because the skill itself lacks versioning, changelog, explicit maintenance ownership and update path, and complete dependency/MCP availability notes.

5Effectiveness6 / 15 · 2.0/5

Rules files, selective context loading, relevant-file inspection, ambiguity escalation, and verification steps can directly guide agents toward better context preparation and are usable for the core task. Points are deducted because no skill-specific output examples or outcome evidence are provided, and comparative benefit over manual practice or alternatives is unverified; static calibration caps this score at 7.

6Verifiability4 / 10 · 2.0/5

A real CI workflow provides static evidence for repository-wide skill validation, evaluation-runner tests, and installation checks. Points are deducted because the supplied test fixture is unrelated to context-engineering, and no dedicated key-path tests or independent corroboration for this skill are shown; static calibration caps this score at 5.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 2fbfa004a019 Review evidence[1][2][3][4][5]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Does this skill require paid services?
The source only states that the repository is MIT-licensed and does not document additional fees. Any cost for MCP services depends on the specific service and configuration, which the source does not specify.
Will it automatically modify project files?
SKILL.md instructs the agent to read relevant files and create rules files, but it does not provide an automation script or define a specific permission model.
When should I trigger it?
Use it when starting a coding session, switching codebase areas, seeing degraded agent output, setting up a project, or when the agent is not following project conventions.
Does it solve every agent error?
No. It focuses on context preparation and ambiguity management; the source does not show that it automatically fixes code, failing tests, or every hallucination problem.

More skills from this repository

All from addyosmani/agent-skills

Dev & Engineering

Intent Interviewer

Clarify the real problem through one-question-at-a-time interviews before planning or coding.

★ 107k FS 59 Recommended 13d ago
Dev & Engineering

Planning & Task Breakdown

Turn clear requirements into ordered, implementable, and verifiable engineering tasks.

★ 107k FS 54 Use with care 13d ago
Dev & Engineering

Idea Refine

Turn vague ideas into tested, actionable product directions.

★ 107k FS 51 Use with care 13d ago
Dev & Engineering

Engineering Workflow Navigator

Find and invoke the right engineering workflow skill for each task phase.

★ 107k FS 46 Use with care 13d ago
Dev & Engineering

Test-Driven Development Workflow

Prove intended behavior with a failing test before implementing, refactoring, and verifying the change.

★ 107k FS 57 Use with care 13d ago
Dev & Engineering

Spec-Driven Development

Turn ambiguous engineering requests into testable specifications before coding.

★ 107k FS 55 Use with care 13d ago
Design & Frontend

Production Frontend UI Engineering

Guides AI coding agents to build accessible, responsive, design-system-aligned production interfaces.

★ 107k FS 53 Use with care 13d ago
Dev & Engineering

Doubt-Driven Development

Challenge non-trivial decisions with a fresh adversarial review before they stand.

★ 107k FS 52 Use with care 13d ago
Dev & Engineering

Incremental Implementation

Deliver multi-file engineering changes through small, tested, reversible slices.

★ 107k FS 52 Use with care 13d ago
Automation & Ops

Security Hardening Engineering Skill

Gives coding agents a structured defense workflow for untrusted input, authentication, sensitive data, and external service integrations.

★ 107k FS 52 Use with care 13d ago
Dev & Engineering

Source-Driven Development

Ground framework and library decisions in current official documentation instead of stale memory.

★ 107k FS 51 Use with care 13d ago
Dev & Engineering

Browser DevTools Testing

Validate and debug web applications with real-browser runtime evidence.

★ 107k FS 59 Recommended 13d ago
Dev & Engineering

Code Clarity Refactor

Reduce code complexity while preserving exact behavior, so teammates can read, modify, and debug it faster.

★ 107k FS 57 Use with care 13d ago
Dev & Engineering

Git Workflow & Release Discipline

Keep AI-generated changes reviewable, reversible, and ready to release.

★ 107k FS 54 Use with care 13d ago
Dev & Engineering

Performance Optimization Engineering Skill

Measure, diagnose, and verify fixes for frontend, backend, query, and database performance bottlenecks.

★ 107k FS 54 Use with care 13d ago
Dev & Engineering

Architecture Decisions & Docs

Preserve engineering context by documenting decisions, APIs, and the reasons behind them.

★ 107k FS 53 Use with care 13d ago
Automation & Ops

Production Observability

Make production behavior visible and diagnosable with structured logs, metrics, traces, and actionable alerts.

★ 107k FS 53 Use with care 13d ago
Dev & Engineering

Stable Interface Design

A practical guide to designing stable, clear, and hard-to-misuse APIs and module interfaces.

★ 107k FS 50 Use with care 13d ago
Dev & Engineering

Pre-Merge Code Quality Review

Review every change across correctness, readability, architecture, security, and performance before it reaches the main branch.

★ 107k FS 49 Use with care 13d ago
Dev & Engineering

Systematic Debugging & Recovery

A structured workflow for finding root causes, fixing failures, and preventing recurrence.

★ 107k FS 49 Use with care 13d ago

Related skills