speckit-agent-context-update

Update coding agent context files to reference the latest Spec Kit plan.

57|13|Updated Jul 12, 2025
One-click install
npx skills add https://github.com/heidsoft/itsm --skill speckit-agent-context-update-heidsoft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-agent-context-update
Source: https://github.com/heidsoft/itsm/tree/main/.claude/skills/speckit-agent-context-update
Command: npx skills add https://github.com/heidsoft/itsm --skill speckit-agent-context-update-heidsoft

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, powershell, and includes scripts (resource) components.

What problem does it solve?

Refreshes the managed Spec Kit section inside the coding agent's context/instruction file, ensuring the guidance block always points to the most recent plan.

Core Features & Use Cases

  • Reads the agent-context extension config at .specify/extensions/agent-context/agent-context-config.yml to locate:
    • context_file — the path of the coding agent context file to manage.
    • context_markers.start / .end — the delimiters surrounding the managed section.
  • Creates, replaces, or appends the managed block so that the section points at the most recent plan path (specs/<feature>/plan.md).
  • Exits safely if context_file is empty or the file cannot be located.

Quick Start

Run the update-agent-context script with an optional plan_path to refresh the coding agent context to the latest plan.

Frequently Asked Questions about speckit-agent-context-update

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update the coding agent context with the latest Spec Kit plan path?

To update the coding agent context, run the update-agent-context script with an optional plan path. It refreshes the managed section in your context file to point to the newest specs/<feature>/plan.md path automatically.

What coding agent instruction files can I manage with Spec Kit context updates?

Spec Kit context updates apply to CLAUDE.md, .github/copilot-instructions.md, and AGENTS.md files. The script locates the specific context file using the agent-context-config.yml configuration.

How does the Spec Kit agent context script locate the managed block in my context file?

The script reads the agent-context-config.yml file to locate the target context file and its defined context_markers.start and .end delimiters. It then updates the managed block between these markers.

Does the coding agent context update script require bash or powershell?

Yes, the script requires either bash or powershell to execute. It relies on these shell environments to run the script execution and modify the coding agent context files safely.

What happens if the agent context file is missing during a Spec Kit plan update?

If the agent context file is missing or the context_file setting is empty, the script exits safely without making changes. This prevents errors when the coding agent context configuration is invalid.

Can I append a managed block to an existing coding agent context file?

Yes, the script can create, replace, or append the managed block in your coding agent context file. This ensures the section references the most recent plan path even if the markers are newly added.