Back to skills
SKILL.md
Aidd Docio
ASecurityOwns shared DocIO runtime for markdown slicing/patching, actions validation/apply, and context-map expansion. Use when stage skills need canonical DocIO operations. Do not use when the request primarily belongs to `aidd-flow-state` lifecycle updates or `aidd-core` ownership routing.
- 5 stars
- 0 votes
- 0 copies
- 0 views
- Added September 6, 2026
Works with
Security analysis
100/100Pro scans all 9 files and shows the line behind each finding
npx -y skills add GrinRus/ai_driven_dev --skill aidd-docio --agent claude-codeAre you the author of Aidd Docio?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/grinrus-aidd-docio)---
name: aidd-docio
description: Owns shared DocIO runtime for markdown slicing/patching, actions validation/apply, and context-map expansion. Use when stage skills need canonical DocIO operations. Do not use when the request primarily belongs to `aidd-flow-state` lifecycle updates or `aidd-core` ownership routing.
lang: en
model: inherit
user-invocable: false
---
## 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
- [references/read-write-maps.md](references/read-write-maps.md) (when: readmap/writemap behavior is in question; why: align map validation and expansion semantics).
- [references/actions-flow.md](references/actions-flow.md) (when: actions schema/apply behavior is unclear; why: follow validator-to-apply lifecycle).
Files in this skill
- SKILL.md
- references/actions-flow.md
- references/read-write-maps.md
- runtime/actions_apply.py
- runtime/actions_validate.py
- runtime/context_expand.py
- runtime/context_map_validate.py
- runtime/md_patch.py
- runtime/md_slice.py
Attribution
Comments
Loading comments…
Newsletter
Get the weekly list of safe new skills, and the ones we pulled.