Claude Code Agent Development
anthropics/claude-plugins-official
Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.
A skill your agent uses when a task is multi-step, may span context resets or sessions, uses subagents, or risks losing state before completion.
$ npx skills add GanyuanRan/Aegis --skill long-task-continuation -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install GanyuanRan/Aegis long-task-continuation --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/GanyuanRan/Aegis.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/long-task-continuation .claude/skills/long-task-continuation && 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 "long-task-continuation" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/long-task-continuation into .claude/skills/long-task-continuation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "long-task-continuation", 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/GanyuanRan/Aegis/tree/main/skills/long-task-continuationType 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 GanyuanRan/Aegis --skill long-task-continuation -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install GanyuanRan/Aegis long-task-continuation --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/long-task-continuation .agents/skills/long-task-continuation && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "long-task-continuation" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/long-task-continuation into .agents/skills/long-task-continuation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "long-task-continuation", 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 GanyuanRan/Aegis --skill long-task-continuation -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install GanyuanRan/Aegis long-task-continuation --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/long-task-continuation .cursor/skills/long-task-continuation && 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 "long-task-continuation" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/long-task-continuation into .cursor/skills/long-task-continuation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "long-task-continuation", 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/GanyuanRan/Aegis.git --path skills/long-task-continuation--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 GanyuanRan/Aegis --skill long-task-continuation -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install GanyuanRan/Aegis long-task-continuation --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/long-task-continuation .gemini/skills/long-task-continuation && 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 "long-task-continuation" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/long-task-continuation into .gemini/skills/long-task-continuation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "long-task-continuation", 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 GanyuanRan/Aegis long-task-continuationInstalls 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 GanyuanRan/Aegis --skill long-task-continuation -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/long-task-continuation .github/skills/long-task-continuation && 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 "long-task-continuation" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/long-task-continuation into .github/skills/long-task-continuation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "long-task-continuation", 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 GanyuanRan/Aegis --skill long-task-continuation -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install GanyuanRan/Aegis long-task-continuation --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/long-task-continuation .opencode/skills/long-task-continuation && 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 "long-task-continuation" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/long-task-continuation into .opencode/skills/long-task-continuation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "long-task-continuation", 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.
long-task-continuationA skill your agent uses when a task is multi-step, may span context resets or sessions, uses subagents, or risks losing state before completion.
Long Task Continuation is an agent skill from GanyuanRan/Aegis. Use when a task is multi-step, may span context resets or sessions, uses subagents, or risks losing state before completion.
Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `durable-work-guidance.md`).
It sits in Agent Workflows, covering Subagents. The repository describes itself as: Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks. The licence is MIT.
5 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 4edf34e. It shows what the files ask for, not the result of running them.
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.
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Long Task Continuation loads about 2.3k tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 1,162 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.
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.
The full file from GanyuanRan/Aegis at commit 4edf34e, republished under its MIT licence (© GanyuanRan). 1,162 words, ~2,343 tokens.
.claude/skills/long-task-continuation/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.Keep long work checkpointed, resumable, drift-aware, and evidence-gated. This protocol does not execute plans, dispatch subagents, run tests, or grant completion authority.
The Method Pack owns continuation discipline only. It does not own the parent
plan, host retry/watchdog behavior, authoritative GateDecision, evidence
sufficiency, requirement acceptance, or completion.
Use this skill when the work has meaningful phases, may be compacted/resumed or handed off, uses subagents, or explicitly needs continuity and drift control. Architecture, contract, shared-workflow, and verification-gate changes also benefit from it. Do not force it onto a short answer or one-command check.
Choose exactly one state carrier:
work/ record for medium+ work that actually crosses sessions,
needs handoff, or requires resumable state;Multi-step, todo-driven, possible-compaction, and subagent use do not force durable records by themselves. Do not create both carriers or a record per slice.
A durable task has one process trail under
docs/aegis/work/YYYY-MM-DD-<slug>/. It keeps logical intent/baseline state,
the latest todo/checkpoint/resume state, terminal evidence/drift state, and a
completion reflection when warranted. These are
TaskIntentDraft, BaselineReadSetHint, BaselineUsageDraft,
ImpactStatementDraft, TodoCheckpointDraft, ResumeStateHint,
DriftCheckDraft, and EvidenceBundleDraft views—not authoritative runtime
records or separate plan owners.
Read only the lifecycle-matched section of durable-work-guidance.md:
## Required Artifact Layout and ## Create A Durable Work Record for a new durable work record;## Update A Slice when an existing helper-backed record needs sidecar updates;## Retry Convergence Detail for retry/attempt bookkeeping;## Pause, Handoff, And Completion Bundle when preparing a pause, handoff, or completion bundle; and## Expanded State Fields only when natural checkpoint prose is ambiguous.The reference owns artifact layout and <aegis-workspace-helper> command
detail; this file owns carrier selection, resume order, drift decisions, and
stop conditions.
An Execution Readiness View may be kept in the intent or active checkpoint
for medium/high, handoff-prone, long-running, subagent-driven, architecture,
contract, compatibility, or retirement-sensitive work. It renders existing
intent, scope, baseline, owner, test, review, and drift constraints; it is not a
new JSON artifact or completion authority.
Planless Slice Lane:
Slice Card: Goal, Parent plan/spec (or
none — direct bounded request), Files, Boundary, Verification, and Stop.verification-before-completion.When durable architecture decisions are in scope, these work records are the preferred ADR Auto Backfill source. Preserve decision signals, source refs, alternatives, compatibility, retirement, drift, and baseline-sync questions.
Before execution:
done | blocked | needs-verification | scope-exceeded).needs-baseline-readback.Execution Readiness View exists, retain its intent lock, scope
fence, baseline lock, compatibility/retirement boundary, tests, reviews,
evidence, and rewind rules.durable-work-guidance.md to create and
structurally check it before implementation.A failed verification is another attempt in the current slice, not a new
slice. Keep failed-attempt telemetry out of terminal evidence and normal
commits. Only evidence-finalized, blocked, or abandoned is terminal.
When retry state reaches process-artifact-pressure, stop auto-retry and route
to systematic-debugging or verification-before-completion. Load the durable
reference only when the attempt/evidence commands or sidecar rules are needed.
Before each slice, state the current goal/todo, intended edits, explicit non-edits, verification, and readiness alignment. A bounded parent-plan or no-parent slice uses the compact Slice Card rather than a new plan/spec.
After each slice, update completed todos, evidence refs, newly used baseline
refs, blockers, next step, and drift decision. When an active helper-backed work record exists, read durable-work-guidance.md and update that same record;
never create another workstream for bookkeeping.
When patch-shape/ripple triage, an H-class finding, or a bounded compatibility
mitigation fired, a locally green result does not clear the direction. Retain
PatchShape, CanonicalOwner, UpwardDrillSignal, latest outcome, and one
bounded evidence ref; do not copy raw logs or full diffs. If no fresh evidence
exists, the state is needs-verification or partial.
Resume in this order:
CONTEXT.md language.Execution Readiness View when present.needs-verification without forcing assent.
If evidence resolves it, retain the supported conclusion and verify normally.Any disagreement among plan, checkpoint, baseline, context, readiness view, or
worktree pauses execution. A semantic conflict routes to
establishing-project-context; an unplanned repair re-reads the retained
invariant, owner seam, patch shape, and causal topology, then route comparison to
systematic-debugging. A new carrier name alone does not prove a new direction. Never resume from memory alone.
Check original intent and stop condition, parent scope/acceptance, compatibility,
new owners/fallbacks/adapters/branches, retirement, evidence freshness, and any
readiness locks. Allowed decisions are continue, pause-for-user,
needs-baseline-readback, needs-verification, and blocked.
Never emit gate-passed, completion-granted, or authoritatively-safe.
Before a completion claim:
aegis:verification-before-completion.durable-work-guidance.md for the completion
bundle and structural workspace check.Generated packs are future-runtime inputs only. Method Pack output remains verified evidence and advisory judgment, not authoritative completion.
Report naturally and omit empty structures. Keep these semantic slots visible:
Aegis Visibility; current todo/active/completed/next; baseline usage decision;
readiness state when present; fresh evidence; inherited-claim corrections when
a resumed record overstated its state; retry/convergence state when
relevant; drift decision; risk/unknown; and the next smallest safe action.
© GanyuanRan, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file in skills/long-task-continuation of GanyuanRan/Aegis.
Open the folder on GitHubat commit 4edf34e
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in GanyuanRan/Aegis, which our catalogue first saw on October 7, 2026.
Long Task Continuation 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 |
|---|---|---|---|---|---|---|
| Long Task Continuation this skillGanyuanRan/Aegis | 1.3k | 1 repos | ~2.3k | Automated safety check: Pass | MIT | |
| Claude Code Agent Developmentanthropics/claude-plugins-official | 38k | 8 repos | ~2.8k | Automated safety check: Pass | Apache-2.0 | |
| Subagent Driven DevelopmentAsvarox/allkaraoke | 261 | 38 repos | ~1.2k | Automated safety check: Pass | None | |
| Dispatching Parallel Agentsultralisp/ultralisp | 258 | 41 repos | ~1.5k | Automated safety check: Pass | None | |
| Paseo Advisor Second Opiniongetpaseo/paseo | 20k | 1 repos | ~756 | Automated safety check: Pass | Custom licence | |
| Task Observerrebelytics/one-skill-to-rule-them-all | 3.2k | 1 repos | ~12k | Automated safety check: Pass | CC-BY-4.0 |
anthropics/claude-plugins-official
Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.
Asvarox/allkaraoke
A skill your agent uses when executing implementation plans with independent tasks in the current session
ultralisp/ultralisp
A skill your agent uses when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
getpaseo/paseo
Launches one separate agent through Paseo to give a second opinion on the current task, with a self-contained briefing and no permission to edit files.
rebelytics/one-skill-to-rule-them-all
Monitors task execution for skill improvement opportunities.
openobserve/openobserve
Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.
GanyuanRan/Aegis
A skill your agent uses when the user says aegis:update, asks to update or upgrade an installed Aegis method-pack, wants the latest Aegis version, or asks whether Aegis is current on this host.
GanyuanRan/Aegis
A skill your agent uses when touching retiring old logic, collapsing duplicate owners, removing fallbacks, or schema/persistence/source-of-truth boundaries; identify opportunities automatically…
GanyuanRan/Aegis
A skill your agent uses when executing a written implementation plan across sessions or with review checkpoints.
GanyuanRan/Aegis
A skill your agent uses when asked for first-principles or Occam's-razor review, or when high-risk decisions involve competing constraints, fallback growth, duplicate owners, or architecture…
GanyuanRan/Aegis
A skill your agent uses when the user explicitly sets an Aegis goal with /aegis-goal, Aegis goal:, or asks to define goal, success evidence, stop condition, or task boundaries before work.
GanyuanRan/Aegis
A skill your agent uses when the user asks to establish shared project language, or project work exposes a conflicting, renamed, or deprecated domain term that needs active semantic modeling.
Categories
A skill your agent uses when a task is multi-step, may span context resets or sessions, uses subagents, or risks losing state before completion. Long Task Continuation is an agent skill from GanyuanRan/Aegis. Use when a task is multi-step, may span context resets or sessions, uses subagents, or risks losing state before completion.
Long Task Continuation fits situations like: A task is multi-step; may span context resets; risks losing state before completion.
Run `npx skills add GanyuanRan/Aegis --skill long-task-continuation -a claude-code`. Or copy the skill folder (skills/long-task-continuation in GanyuanRan/Aegis) into .claude/skills/long-task-continuation in your project. Claude Code loads it when a task matches its description.
Run `npx skills add GanyuanRan/Aegis --skill long-task-continuation -a codex`. Or copy the skill folder (skills/long-task-continuation in GanyuanRan/Aegis) into .agents/skills/long-task-continuation in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GanyuanRan/Aegis --skill long-task-continuation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/long-task-continuation, .gemini/skills/long-task-continuation, .github/skills/long-task-continuation and .opencode/skills/long-task-continuation in your project.
SKILL.md names no scripts, command-line tools or credentials: Long Task Continuation is instructions for the agent only.
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.
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.
Long Task Continuation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.3k tokens (SKILL.md is roughly 9.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Long Task Continuation: Claude Code Agent Development (anthropics/claude-plugins-official, 38k stars), Subagent Driven Development (Asvarox/allkaraoke, 261 stars), Dispatching Parallel Agents (ultralisp/ultralisp, 258 stars) and Paseo Advisor Second Opinion (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
GanyuanRan (a GitHub user) maintains it in GanyuanRan/Aegis, which has 1,327 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 3, 2026.
Source: GanyuanRan/Aegis on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.