Aidd Observability

Name: Aidd Observability
Author: GrinRus

ASecurity

Owns shared observability/runtime reporting for diagnostics, inventory, identifiers, logs, and DAG export. Use when deterministic diagnostics or inventory exports are required. Do not use when request scope is `status` stage summaries or `aidd-core` runtime ownership mapping.

5 stars
0 votes
0 copies
2 views
Added September 6, 2026

testingpythonapi

Works with

Security analysis

A100/100

Pro scans all 8 files and shows the line behind each finding

Scanned September 6, 2026

npx -y skills add GrinRus/ai_driven_dev --skill aidd-observability --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Aidd Observability?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Aidd Observability

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/grinrus-aidd-observability/badge)](https://www.skillsdirectory.com/skills/grinrus-aidd-observability)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
name: aidd-observability
description: Owns shared observability/runtime reporting for diagnostics, inventory, identifiers, logs, and DAG export. Use when deterministic diagnostics or inventory exports are required. Do not use when request scope is `status` stage summaries or `aidd-core` runtime ownership mapping.
lang: en
model: inherit
user-invocable: false
---

## Scope
- This skill owns shared observability/reporting runtime entrypoints.
- Commands here support diagnostics, inventory generation, execution logs, and graph/report exports.
- Stage orchestration ownership remains in stage skills, `feature-dev-aidd:aidd-flow-state`, and `feature-dev-aidd:aidd-loop`.

## Canonical shared Python entrypoints
- `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/doctor.py`
- `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/tools_inventory.py`
- `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/tests_log.py`
- `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/dag_export.py`
- `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/identifiers.py`

## Command contracts
### `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/doctor.py`
- When to run: when environment/runtime path drift or tooling prerequisites are suspected.
- Inputs: optional workspace and diagnostics flags.
- Outputs: deterministic environment health report and actionable remediation hints.
- Failure mode: non-zero exit if required dependencies/path assumptions fail validation.
- Next action: apply reported environment fixes and rerun doctor before stage retry.

### `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/tools_inventory.py`
- When to run: when ownership/runtime API inventory must be regenerated for audits.
- Inputs: plugin root with optional output path filters.
- Outputs: normalized inventory snapshot for skills/runtime ownership checks.
- Failure mode: non-zero exit on inventory generation or schema serialization failures.
- Next action: fix inventory generation issue and rerun the command.

## Ownership guard
- Observability/reporting command modules must live under `skills/aidd-observability/runtime/*`.
- Consumers should reference `skills/aidd-observability/runtime/*` as canonical command paths.

## Additional resources
- [references/inventory-contract.md](references/inventory-contract.md) (when: ownership/inventory output is in question; why: keep report schema and consumers aligned).
- [references/diagnostics.md](references/diagnostics.md) (when: environment/diagnostics behavior is unclear; why: keep doctor/tests-log output deterministic).