Paradox Projects
projects/create-context-skill
Open source skillTemplate v5

Add the business logic your code cannot explain.

A Codex skill for creating and maintaining `docs/CONTEXT.md`: the place for domain rules, decisions, boundaries, project relationships, and operational details that source code alone cannot reveal.

Install skillSee featuresView on GitHub

How to use it

Invoke it with @create-context.

Run it from the root of your project, whether it has not been initialized yet or you already have an older `docs/CONTEXT.md` you want to update. If you also want to add projects to the ecosystem, just mention them and pass the full path or URL of each one.

Capabilities

A practical context system for agentic coding.

Turn implicit knowledge into actionable context: why the project exists, what an AI must not assume, how it relates to other repositories, and which mistakes should not be repeated.

Business

Context for what code cannot say

Capture product intent, domain rules, project boundaries, and decisions that are easy to miss when reading source files alone.

  • Business goals, non-goals, and current focus
  • Non-obvious rules that shape implementation choices
  • Explicit notes on what an agent should not assume
Ecosystem

Cross-repo awareness

Map how related projects fit together, so work in one repository can be understood in the context of the wider system.

  • Project roles, relationships, and ownership boundaries
  • Private local paths kept in ecosystem.local.md
  • Pointers for when a neighboring repo should be checked
Changelog

History that prevents repeat mistakes

Keep fixes, decisions, and project milestones connected to a dated history that future sessions can inspect quickly.

  • Detailed changes live in root CHANGELOG.md
  • CONTEXT.md keeps a concise milestone summary
  • Resolved problems and their fixes remain visible
Confidence

Clear evidence boundaries

Separate confirmed project knowledge from cautious interpretation, so agents know when to act and when to verify.

  • Critical facts can be marked as verified, inferred, or user-confirmed
  • Unknown sections stay explicit instead of being guessed
  • Uncertainties and prior research are kept in view
Bootstrap

Context without repeated reminders

Add a short pointer in AGENTS.md so future AI sessions know to read and maintain the context file from the start.

  • Checks or creates AGENTS.md when needed
  • Places the context requirement at the top
  • Keeps documentation maintenance part of the workflow
Operations

Repository workbench

Turn scattered project facts into a runbook with structure, commands, validation, and common task routes.

  • Repository structure, stack, CI/CD, and sources of truth
  • Task-to-file map and practical implementation recipes
  • Validation checklist, gotchas, and next steps

Lifecycle

Built for long-lived repos.

The skill covers first-time generation, template migration, and ongoing documentation upkeep.

1

Create

Build a first docs/CONTEXT.md from repository evidence and a complete v5 structure.

2

Migrate

Upgrade older CONTEXT.md files without flattening useful manual notes.

3

Maintain

Keep context, changelog, and agent instructions aligned after meaningful changes.

Install

Install it with npx skills.

Use the open agent skills CLI and choose the agent and scope during installation. For Codex, open a new thread after installing.

Open on GitHub
Install

Open the interactive installer from the open source repository.

npx skills add paradox-solutions/create-context-skill
Update

Update the global install after publishing changes to the repo.

npx skills update create-context -g

Evolution

Improvements built into the skill.

The template has become stricter about capturing context: less generic prose, more useful evidence, and better continuity between sessions.

v5

Operational context and explicit evidence

Refocuses the document on actionable decisions and business knowledge that does not live in the code.

  • Operational TL;DR at the top so an AI can quickly understand the project state.
  • New areas for non-assumptions, sources of truth, and non-obvious business rules.
  • Confidence markers for verified, inferred, and user-confirmed facts.
  • Patch-based migrations that preserve curated notes instead of rewriting the whole context.
v4

More reliable bootstrap for future sessions

Makes the context easier for any incoming AI to discover and follow.

  • Quick index at the beginning of CONTEXT.md.
  • Embedded ecosystem instructions that work even without the skill.
  • AGENTS.md validation so the repo remembers to read and maintain context.
v3

Cross-project ecosystem awareness

Adds support for understanding repository relationships and avoiding isolated changes.

  • New project ecosystem section.
  • Private absolute paths separated into docs/ecosystem.local.md.
  • Cross-update process when relationships between repositories are discovered.
v2

Changelog and companion documentation

Separates detailed history from context summary so both remain useful.

  • Detailed changelog moves to the root CHANGELOG.md.
  • CONTEXT.md keeps only a compact milestone table.
  • Template version tracking and an index for additional docs.

An open source project by Paradox Solutions.

paradox-solutions/create-context-skill