Agent skill
aidd-docio
Owns shared DocIO runtime for markdown slicing/patching, actions validation/apply, and context-map expansion. Use when stage skills need canonical DocIO operations.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/aidd-docio
SKILL.md
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-coreandfeature-dev-aidd:aidd-loop.
Canonical shared Python entrypoints
python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/md_slice.pypython3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/md_patch.pypython3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/actions_validate.pypython3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/actions_apply.pypython3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-docio/runtime/context_map_validate.pypython3 ${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.jsonis 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
- references/read-write-maps.md (when: readmap/writemap behavior is in question; why: align map validation and expansion semantics).
- references/actions-flow.md (when: actions schema/apply behavior is unclear; why: follow validator-to-apply lifecycle).
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?