Remember
antonio-orionus/Arroxy
Persists a durable Arroxy lesson — a gotcha, user preference, workflow rule, or design decision — to the right tracked file (project memory, AGENTS.md, CONTEXT.md, dev-docs, or an ADR) so any coding…
Decide where a learning, gotcha, or decision should live so it is not lost, and capture it there while context is fresh.
Install Expectations
$ npx skills add citypaul/.dotfiles --skill expectations -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install citypaul/.dotfiles expectations --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/citypaul/.dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/claude/.claude/skills/expectations .claude/skills/expectations && rm -rf skills-srcUse ~/.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/
Install the "expectations" agent skill from https://github.com/citypaul/.dotfiles/tree/main/claude/.claude/skills/expectations into .claude/skills/expectations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "expectations", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/citypaul/.dotfiles/tree/main/claude/.claude/skills/expectationsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add citypaul/.dotfiles --skill expectations -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install citypaul/.dotfiles expectations --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/citypaul/.dotfiles.git skills-src && mkdir -p .agents/skills && cp -r skills-src/claude/.claude/skills/expectations .agents/skills/expectations && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "expectations" agent skill from https://github.com/citypaul/.dotfiles/tree/main/claude/.claude/skills/expectations into .agents/skills/expectations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "expectations", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add citypaul/.dotfiles --skill expectations -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install citypaul/.dotfiles expectations --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/citypaul/.dotfiles.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/claude/.claude/skills/expectations .cursor/skills/expectations && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "expectations" agent skill from https://github.com/citypaul/.dotfiles/tree/main/claude/.claude/skills/expectations into .cursor/skills/expectations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "expectations", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/citypaul/.dotfiles.git --path claude/.claude/skills/expectations--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add citypaul/.dotfiles --skill expectations -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install citypaul/.dotfiles expectations --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/citypaul/.dotfiles.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/claude/.claude/skills/expectations .gemini/skills/expectations && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "expectations" agent skill from https://github.com/citypaul/.dotfiles/tree/main/claude/.claude/skills/expectations into .gemini/skills/expectations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "expectations", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install citypaul/.dotfiles expectationsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add citypaul/.dotfiles --skill expectations -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/citypaul/.dotfiles.git skills-src && mkdir -p .github/skills && cp -r skills-src/claude/.claude/skills/expectations .github/skills/expectations && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "expectations" agent skill from https://github.com/citypaul/.dotfiles/tree/main/claude/.claude/skills/expectations into .github/skills/expectations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "expectations", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add citypaul/.dotfiles --skill expectations -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install citypaul/.dotfiles expectations --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/citypaul/.dotfiles.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/claude/.claude/skills/expectations .opencode/skills/expectations && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "expectations" agent skill from https://github.com/citypaul/.dotfiles/tree/main/claude/.claude/skills/expectations into .opencode/skills/expectations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "expectations", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
expectations- GitHub stars
- 740
- Token cost
- ~1.2k tokens
- SKILL.md length
- 468 words
- Files
- 1
- Skills in repo
- 44
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Decide where a learning, gotcha, or decision should live so it is not lost, and capture it there while context is fresh.
- The user says they just discovered
- SKILL.md covers Reusable Principle or Local…, Documentation Framework, Types of Learnings to Capture and Where Each Learning Goes, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Found out something non-obvious
What it does
Expectations is an agent skill from citypaul/.dotfiles. Decide where a learning, gotcha, or decision should live so it is not lost, and capture it there while context is fresh. Use when the user says they just discovered, learned, or found out something non-obvious, asks where a fact should be recorded, written down, or go, wants a setup gotcha, workaround, or decision kept for the next person or the next agent session, or asks whether something belongs in CLAUDE.md, a README, an ADR, tests, a glossary, or a reusable skill. Routes each fact to its durable owner and…
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Architecture decision records, Domain-driven design and Technical writing.
When your agent uses it
- The user says they just discovered
- Found out something non-obvious
- Asks where a fact should be recorded
- Wants a setup gotcha
Example prompts
- “/expectations”
What it can do on your machine
Read from SKILL.md and the folder at commit cd4028d. 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
No URLs in SKILL.md.
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
Expectations loads about 1.2k tokens when it runs. Until then it costs about 173 tokens; SKILL.md has 468 words of instructions outside code blocks.
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 468 words (~1,173 tokens).
“Route each discovery to the artifact that owns its truth. Do not turn one project's architecture, delivery process, or tooling conventions into universal guidance.”
- name
- expectations
Files
Just SKILL.md in claude/.claude/skills/expectations of citypaul/.dotfiles.
Open the folder on GitHubat commit cd4028d
Compare with similar skills
Expectations 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Expectations this skillcitypaul/.dotfiles | 740 | — | ~1.2k | Automated safety check: Pass | Custom licence | |
| Rememberantonio-orionus/Arroxy | 391 | — | ~571 | Automated safety check: Pass | MIT | |
| Diataxis Docspmndrs/glyph | 395 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Ad DriftCorridorTech/PoseCap | 224 | — | ~1.8k | Automated safety check: Notes | Apache-2.0 | |
| Documentationextra-org/extra | 113 | — | ~848 | Automated safety check: Pass | MIT | |
| RFC Creatortech-leads-club/agent-skills | 7k | — | ~2.9k | Automated safety check: Pass | CC-BY-4.0 |
Similar skills
Diataxis Docs
pmndrs/glyph
Design, classify, write, audit, or restructure technical documentation with the Diátaxis framework.
Ad Drift
CorridorTech/PoseCap
Read-only drift audit — compare AGENTS.md, ARCHITECTURE.md, ADR statuses, feature specs in doc/specs/, and documentation discipline against what the code actually does.
Documentation
extra-org/extra
Keep the repository's documentation accurate, honest, and synchronized with the code.
RFC Creator
tech-leads-club/agent-skills
Drafts Request for Comments documents that lay out a proposal, the options weighed and the decision needed, so approvers can align before a major change.
Ad Review
CorridorTech/PoseCap
Two-axis fresh-context code review per WORKFLOW §10. An agent skill from CorridorTech/PoseCap.
More from citypaul/.dotfiles
All 44 skills in this repoFind Skills
citypaul/.dotfiles
Discover and, with authorization, install agent skills from the open skills ecosystem.
Render Code Shape
citypaul/.dotfiles
Render the shape of code — module boundaries, the types that cross them, signatures, and a cited call graph — for code that already exists or a change about to be built.
Structure Codebase
citypaul/.dotfiles
Design, audit, and evolve physical source and package structures that expose real architectural boundaries while keeping related behavior together.
Test Design Reviewer
citypaul/.dotfiles
Review test quality using Dave Farley's eight properties of good tests.
Characterisation Tests
citypaul/.dotfiles
A skill your agent uses when modifying existing code that lacks tests and you need to document its actual current behavior before making changes -- the legacy code dilemma where you need tests to…
CI Debugging
citypaul/.dotfiles
Systematic CI/CD failure diagnosis using hypothesis-first investigation, local reproduction, and environment delta analysis.
Related
Questions about Expectations
What does Expectations do?
Decide where a learning, gotcha, or decision should live so it is not lost, and capture it there while context is fresh. dotfiles. Decide where a learning, gotcha, or decision should live so it is not lost, and capture it there while context is fresh.
When should I use Expectations?
Expectations fits situations like: the user says they just discovered; found out something non-obvious; asks where a fact should be recorded; wants a setup gotcha.
How do I install Expectations in Claude Code?
Run `npx skills add citypaul/.dotfiles --skill expectations -a claude-code`. Or copy the skill folder (claude/.claude/skills/expectations in citypaul/.dotfiles) into .claude/skills/expectations in your project. Claude Code loads it when a task matches its description.
How do I install Expectations in Codex?
Run `npx skills add citypaul/.dotfiles --skill expectations -a codex`. Or copy the skill folder (claude/.claude/skills/expectations in citypaul/.dotfiles) into .agents/skills/expectations in your project. Codex loads it when a task matches its description.
Can I use Expectations 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 citypaul/.dotfiles --skill expectations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/expectations, .gemini/skills/expectations, .github/skills/expectations and .opencode/skills/expectations in your project.
What does Expectations need to run?
SKILL.md names no scripts, command-line tools or credentials: Expectations is instructions for the agent only.
Does Expectations access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Expectations 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 Expectations use?
Expectations 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 Expectations use?
About 1.2k tokens (SKILL.md is roughly 4.7k 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 Expectations?
Skills that share tags, products or a category with Expectations: Remember (antonio-orionus/Arroxy, 391 stars), Diataxis Docs (pmndrs/glyph, 395 stars), Ad Drift (CorridorTech/PoseCap, 224 stars) and Documentation (extra-org/extra, 113 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Expectations?
citypaul (a GitHub user) maintains it in citypaul/.dotfiles, which has 740 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 9, 2026.
Source: citypaul/.dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.