Skip to content
Skills Library
AI & agents · Building & coding

create-context

/create-context

Create the .agentcontext file (a hidden per-project brief that load-context reads and update-context maintains) for the project in the current working directory. Use when the user says "make agent context", "create agent context file", "set up context for this project", or when load-context reports that none exists yet.

Repository
session-kit ↗
Licence
MIT
Last repository change
06.11.2026

Assessment and security

86/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content21 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 06.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Create the .agentcontext file (a hidden per-project brief that load-context reads and update-context maintains) for the project in the current working directory. Use when the user says "make agent context", "create agent context file", "set up context for this project", or when load-context reports that none exists yet.

Triggers from the description

make agent contextcreate agent context fileset up context for this project
Original author description

Create the .agentcontext file (a hidden per-project brief that load-context reads and update-context maintains) for the project in the current working directory. Use when the user says "make agent context", "create agent context file", "set up context for this project", or when load-context reports that none exists yet.

How it works

  1. Steps
Original SKILL.md headings · 18 lines, 305 words
SKILL.md preview
---
name: create-context
description: Create the .agentcontext file (a hidden per-project brief that load-context reads and update-context maintains) for the project in the current working directory. Use when the user says "make agent context", "create agent context file", "set up context for this project", or when load-context reports that none exists yet.
---

Create a `.agentcontext` file in the current working directory: a compact, standing brief so future sessions in this project start informed instead of asking the user to explain everything again.

## Steps

1. Check whether `.agentcontext` already exists in the current working directory. If it does, ask the user before overwriting it, even in autonomous mode: an overwrite can't be undone.
2. Gather what should go in it:
   - Look for a README (or a similar orientation doc) in the current working directory or the repo root.
   - Pull from the current conversation and from the user: what the project is, its structure and conventions, and any in-flight status worth tracking.
3. Write `.agentcontext` with this shape:
   - A one-paragraph orientation: what the project is, in plain terms.
   - A pointer telling the reader to read the README (name it, if one was found) for the full story. This file is a brief, not a copy of the README.
   - A **Structure & conventions** section: standing rules that would trip up a future session the same way twice. Only what's durable; don't restate what the README already covers well.
   - A **Current status** section: point-in-time facts (in-flight work, active branches, running services). Note that the `update-context` skill (`/session-kit:update-context`) keeps this section current.
4. Keep it terse: one line per fact, no padding.
5. If the folder is inside a git repo and `git check-ignore -q .agentcontext` fails, append `.agentcontext` to the clone's exclude file (`git rev-parse --git-path info/exclude` prints its path, usually `.git/info/exclude`). That file is private to this clone, so nothing tracked changes. Tell the user in one line, and mention that they can list it in `.gitignore` instead if they want the ignore rule shared.
6. Tell the user that `.agentcontext` was created (it's a hidden dotfile) and summarize what went into it.

Versions

RepositoryScoreLicence
This page · ducky8x/session-kit86MIT
digital-stoic-org/agent-skills100MIT
pantheon-org/tekhne100MIT

Database snapshot: 13.11.2026 · package version 100380d09e6f (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 96load-context
    Load the standing project context for the current working directory so you can start work right away without being re-briefed. Reads every .agentcontext file (a hidden per-project brief) found in the current directory and its ancestors, plus whatever README each one points to.…
  • 86update-context
    Update the current directory's .agentcontext file with what happened in this conversation (work completed, work still to do) and prune anything that's gone stale. Works in any project. Use when the user says "update context", "save this to context", "update the agent context".
  • 90gds-generate-project-context
    Create optimized project-context.md for AI agent consistency. Use when the user says "project context" or "generate context
  • 90gds-generate-project-context
    Create optimized project-context.md for AI agent consistency. Use when the user says "project context" or "generate context
  • 98state
    Use when the user says 'update state', 'project state', 'where was I', or at session start to load current context.
  • 100agents-md-generator
    Generate or update an AGENTS.md / CLAUDE.md / context file for a repo. Use when the user says "set up CLAUDE.md", "generate AGENTS.md", "write a context file for this repo", "document this codebase for AI agents", or when a fresh repo has none. Also use when an existing context…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.