context-engineering-collection — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited context-engineering-collection (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
A comprehensive, open collection of Agent Skills focused on context engineering and harness engineering principles for building production-grade AI agent systems. These skills teach the art and science of curating context, designing agent operating loops, and evaluating agent behavior across any agent platform.
Context engineering is the discipline of managing the language model's context window. Unlike prompt engineering, which focuses on crafting effective instructions, context engineering addresses the holistic curation of all information that enters the model's limited attention budget: system prompts, tool definitions, retrieved documents, message history, and tool outputs.
The fundamental challenge is that context windows are constrained not by raw token capacity but by attention mechanics. As context length increases, models exhibit predictable degradation patterns: the "lost-in-the-middle" phenomenon, U-shaped attention curves, and attention scarcity. Effective context engineering means finding the smallest possible set of high-signal tokens that maximize the likelihood of desired outcomes.
This repository is cited in academic research as foundational work on static skill architecture:
"While static skills are well-recognized [Anthropic, 2025b; Muratcan Koylan, 2025], MCE is among the first to dynamically evolve them, bridging manual skill engineering and autonomous self-improvement."
These skills establish the foundational understanding required for all subsequent context engineering work.
| Skill | Description |
|---|---|
| context-fundamentals | Understand what context is, why it matters, and the anatomy of context in agent systems |
| context-degradation | Recognize patterns of context failure: lost-in-middle, poisoning, distraction, and clash |
| context-compression | Design and evaluate compression strategies for long-running sessions |
These skills cover the patterns and structures for building effective agent systems.
| Skill | Description |
|---|---|
| multi-agent-patterns | Master orchestrator, peer-to-peer, and hierarchical multi-agent architectures |
| memory-systems | Design short-term, long-term, and graph-based memory architectures |
| tool-design | Build tools that agents can use effectively |
| filesystem-context | Use filesystems for dynamic context discovery, tool output offloading, and plan persistence |
| hosted-agents | NEW Build background coding agents with sandboxed VMs, pre-built images, multiplayer support, and multi-client interfaces |
These skills address the ongoing operation and optimization of agent systems.
| Skill | Description |
|---|---|
| context-optimization | Apply compaction, masking, and caching strategies |
| latent-briefing | Share task-relevant orchestrator state with workers via task-guided KV cache compaction when the worker runtime is controllable |
| evaluation | Build evaluation frameworks for agent systems |
| advanced-evaluation | Master LLM-as-a-Judge techniques: direct scoring, pairwise comparison, rubric generation, and bias mitigation |
| harness-engineering | Design autonomous agent harnesses with locked metrics, durable logs, novelty gates, rollback, and human approval boundaries |
These skills cover the meta-level practices for building LLM-powered projects.
| Skill | Description |
|---|---|
| project-development | Design and build LLM projects from ideation through deployment, including task-model fit analysis, pipeline architecture, and structured output design |
These skills cover formal cognitive modeling for rational agent systems.
| Skill | Description |
|---|---|
| bdi-mental-states | NEW Transform external RDF context into agent mental states (beliefs, desires, intentions) using formal BDI ontology patterns for deliberative reasoning and explainability |
Each skill is structured for efficient context use. At startup, agents load only skill names and descriptions. Full content loads only when a skill is activated for relevant tasks.
These skills focus on transferable principles rather than vendor-specific implementations. The patterns work across Claude Code, Cursor, and any agent platform that supports skills or allows custom instructions.
Scripts and examples demonstrate concepts using Python pseudocode that works across environments without requiring specific dependency installations.
This repository is a Claude Code Plugin Marketplace containing context engineering skills that Claude automatically discovers and activates based on your task context.
Step 1: Add the Marketplace
Run this command in Claude Code to register this repository as a plugin source:
/plugin marketplace add muratcankoylan/Agent-Skills-for-Context-EngineeringStep 2: Install the Plugin
Option A - Browse and install:
Browse and install pluginscontext-engineering-marketplacecontext-engineeringInstall nowOption B - Direct install via command:
/plugin install context-engineering@context-engineering-marketplaceThis installs all 15 skills in a single plugin. Skills are activated automatically based on your task context.
| Skill | Activate When |
|---|---|
context-fundamentals | Establishing context-window mental models, planning agent architecture, or explaining how context components affect model behavior |
context-degradation | Diagnosing attention failures, context poisoning, lost-in-middle behavior, or degraded agent performance across long sessions |
context-compression | Preserving useful state while reducing conversation, tool-output, or trajectory size under context pressure |
context-optimization | Improving token efficiency, retrieval precision, prefix reuse, masking, partitioning, or budget allocation for agent systems |
latent-briefing | Sharing orchestrator trajectory with workers via task-guided KV cache compaction when the worker runtime is controllable and the models are compatible |
multi-agent-patterns | Choosing coordination patterns, isolating context across agents, designing handoffs, or evaluating whether parallel agents are justified |
memory-systems | Persisting cross-session knowledge, tracking entities over time, choosing memory frameworks, or designing retrieval and update semantics |
tool-design | Defining agent-tool contracts, consolidating tool surfaces, improving descriptions, or making tool errors actionable |
filesystem-context | Moving large or durable context into files, creating scratchpads, supporting just-in-time discovery, or coordinating agents through shared artifacts |
hosted-agents | Running coding agents in remote sandboxes, background environments, warm pools, or multiplayer agent infrastructure |
evaluation | Creating deterministic checks, rubrics, regression suites, production monitoring, or quality gates for agent behavior |
advanced-evaluation | Using LLM judges, pairwise comparison, calibration, bias mitigation, or human-aligned quality assessment |
harness-engineering | Designing autonomous loops with locked evaluators, editable surfaces, durable logs, novelty gates, rollback, and approval boundaries |
project-development | Deciding whether an LLM is appropriate, shaping batch pipelines, creating staged artifacts, or estimating operational cost |
bdi-mental-states | Modeling beliefs, desires, intentions, rational action traces, or neuro-symbolic state transformations for agents |
<img width="1014" height="894" alt="Screenshot 2025-12-26 at 12 34 47 PM" src="https://github.com/user-attachments/assets/f79aaf03-fd2d-4c71-a630-7027adeb9bfe" />
This repository is listed on the Cursor Plugin Directory.
The .plugin/plugin.json manifest follows the Open Plugins standard, so the repo also works with any conformant agent tool (Codex, GitHub Copilot, etc.).
To use a single skill without installing the full plugin, copy its SKILL.md directly into your project's .claude/skills/ directory:
# Example: add just the context-fundamentals skill
mkdir -p .claude/skills
curl -o .claude/skills/context-fundamentals.md \
https://raw.githubusercontent.com/muratcankoylan/Agent-Skills-for-Context-Engineering/main/skills/context-fundamentals/SKILL.mdAvailable skills: context-fundamentals, context-degradation, context-compression, context-optimization, latent-briefing, multi-agent-patterns, memory-systems, tool-design, filesystem-context, hosted-agents, evaluation, advanced-evaluation, harness-engineering, project-development, bdi-mental-states
Extract the principles and patterns from any skill and implement them in your agent framework. The skills are deliberately platform-agnostic.
The examples folder contains complete system designs that demonstrate how multiple skills work together in practice.
| Example | Description | Skills Applied |
|---|---|---|
| digital-brain-skill | NEW Personal operating system for founders and creators. Complete Claude Code skill with 6 modules, 4 automation scripts | context-fundamentals, context-optimization, memory-systems, tool-design, multi-agent-patterns, evaluation, project-development |
| x-to-book-system | Multi-agent system that monitors X accounts and generates daily synthesized books | multi-agent-patterns, memory-systems, context-optimization, tool-design, evaluation |
| llm-as-judge-skills | Production-ready LLM evaluation tools with TypeScript implementation, 19 passing tests | advanced-evaluation, tool-design, context-fundamentals, evaluation |
| book-sft-pipeline | Train models to write in any author's style. Includes Gertrude Stein case study with 70% human score on Pangram, $2 total cost | project-development, context-compression, multi-agent-patterns, evaluation |
| interleaved-thinking | Reasoning trace optimizer that captures, analyzes, and converts agent failure patterns into generated skills | evaluation, advanced-evaluation, context-degradation, harness-engineering |
Each example includes:
The digital-brain-skill example is a complete personal operating system demonstrating comprehensive skills application:
Includes detailed traceability in HOW-SKILLS-BUILT-THIS.md mapping every architectural decision to specific skill principles.
The llm-as-judge-skills example is a complete TypeScript implementation demonstrating:
The book-sft-pipeline example demonstrates training small models (8B) to write in any author's style:
Integrates with context engineering skills: project-development, context-compression, multi-agent-patterns, evaluation.
The researcher directory is a file-based operating system for turning external research into skill changes. It exists so this repository can act as a compounding source of truth instead of an anthology.
The skill router (which decides whether the right skill gets loaded for a given task) has been benchmarked end-to-end against four frontier models via the Cursor SDK. Three full sweeps (50 prompts x 4 models x 3 replications = 600 calls each):
researcher/benchmarks/router/results-published/2026-05-15.mdresearcher/benchmarks/router/results-published/2026-05-15-v2.md (includes delta-vs-baseline)researcher/benchmarks/router/results-published/2026-05-19.md (600/600 usable records, 0 format failures)Per-skill effect size for the three skills the data flagged:
| Skill | Baseline top-1 | After rewrite | Delta |
|---|---|---|---|
context-fundamentals | 0.255 | 0.489 | +23.4pp |
project-development | 0.750 | 1.000 | +25pp (now perfect) |
tool-design | 0.729 | 0.807 | +7.8pp |
Per-model top-1 accuracy after the corpus-wide hardening pass:
| Model | Top-1 | Top-3 |
|---|---|---|
| gemini-3.1-pro | 0.920 | 0.933 |
| composer-2 | 0.913 | 0.947 |
| gpt-5.5 | 0.913 | 0.973 |
| claude-opus-4-7 | 0.840 | 0.933 |
Reproduce any of these numbers exactly via the runner under researcher/benchmarks/sdk-runner/.
researcher/source-registry.md): priority sources, exclusion rules, monitoring queries.researcher/rubrics/): content curation, skill change, harness change, pairwise skill revision.researcher/mechanisms/registry.jsonl + ledgers/): 16 accepted behavior changes used as the primary novelty signal, with append-only accepted/rejected ledgers for institutional memory.researcher/claims/index.jsonl): 12 provenance-tracked claims with source URL, evidence strength, volatility, and last reviewed date.researcher/corpus/index.json): canonical machine-readable map of skills, activation scenarios, mechanism IDs, and claim IDs.researcher/runs/<run-id>/run-state.json): initialized -> retrieved -> evaluated -> proposed -> novelty_checked -> validated -> pr_ready -> closed.researcher/fixtures/activation-cases.jsonl): 19 deterministic prompts that catch skill-boundary confusion.researcher/benchmarks/): scenarios that try to game the loop (duplicate mechanisms, unretrieved evidence, wrong rubric math, self-approved rubric changes, weak-evidence novelty).researcher/scripts/loop_*.py + researcher/orchestration/launchd/): inbox, source discovery, one-state-at-a-time advancement, daily ops, parked review queue, launchd service definitions.researcher/scripts/skill_health.py): deterministic body-quality scoring; current strict corpus score is 0.9117 with 0 flagged skills.# Deterministic gates (also run in CI on every PR)
python3 researcher/scripts/validate_repo.py --strict
python3 researcher/scripts/skill_health.py --strict --no-history
python3 researcher/scripts/run_benchmarks.py
python3 researcher/scripts/check_activation_cases.py
# Per-run readiness (active runs only)
python3 researcher/scripts/validate_run.py --run-dir researcher/runs/<run-id>
# Continuous loop, manual
python3 researcher/scripts/loop_discover.py
python3 researcher/scripts/loop_step.py --allow-fetch
python3 researcher/scripts/loop_daily.py
python3 researcher/scripts/loop_status.py
# Continuous loop, daemon (macOS)
researcher/orchestration/launchd/install.sh # install launchd jobs (10-min step, 12h discover, daily ops)
researcher/orchestration/launchd/uninstall.sh # remove launchd jobsSee researcher/runbooks/continuous-operation.md for daemon details, budgets, and the human review surface.
os.replace) and serialized via fcntl locks.<img width="3664" height="2808" alt="star-history-2026526" src="https://github.com/user-attachments/assets/c9f88769-21b8-4762-9472-d4cf1fe1c802" />
Each skill follows the Agent Skills specification:
skill-name/
├── SKILL.md # Required: instructions + metadata
├── scripts/ # Optional: executable code demonstrating concepts
└── references/ # Optional: additional documentation and resourcesSee the template folder for the canonical skill structure.
This repository follows the Agent Skills open development model. Contributions are welcome from the broader ecosystem. When contributing:
Feel free to contact Muratcan Koylan for collaboration opportunities or any inquiries.
MIT License - see LICENSE file for details.
The principles in these skills are derived from research and production experience at leading AI labs and framework developers. Each skill includes references to the underlying research and case studies that inform its recommendations.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.