OpenParable
Skip to content
← Back to skills

Aidd Docio

Documents
aidd-docio

Aidd Docio is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Owns shared DocIO runtime for markdown slicing/patching, actions validation/apply, and context-map expansion. Use when stage skills need canonical DocIO operations.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/documents/aidd-docio/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/aidd-docio, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Scope

  • This skill owns shared DocIO runtime entrypoints.
  • Stage skills consume these APIs for preflight/postflight and deterministic document updates.
  • Flow-state orchestration remains in feature-dev-aidd:aidd-core and feature-dev-aidd:aidd-loop.

Canonical shared Python entrypoints

  • python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/md_slice.py
  • python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/md_patch.py
  • python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/actions_validate.py
  • python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/actions_apply.py
  • python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/context_map_validate.py
  • python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/context_expand.py

Command contracts

python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/md_slice.py

  • When to run: when stage or subagent needs bounded section reads instead of full-file scans.
  • Inputs: source markdown path with heading/line selectors.
  • Outputs: deterministic excerpt payload for pack-first evidence workflows.
  • Failure mode: non-zero exit on missing file, invalid selectors, or malformed markdown boundaries.
  • Next action: fix selectors/source path and rerun the same slice command.

python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/actions_apply.py

  • When to run: stage-chain postflight after validated *.actions.json is available.
  • Inputs: --actions <path> with optional apply-log paths and stage context.
  • Outputs: applied updates, progress synchronization, and downstream stage artifacts.
  • Failure mode: non-zero exit on schema violations, write failures, or boundary guard blocks.
  • Next action: inspect apply log, fix action payload/root cause, then rerun stage-chain postflight.

Ownership guard

  • DocIO-facing runtime modules must be implemented under skills/aidd-docio/runtime/*.
  • Consumers should reference skills/aidd-docio/runtime/* as canonical paths.

Additional resources