Doctor report: request

[scandreck]

Public GitHub skill URL

https://github.com/eclipse-cyclonedds/cyclonedds-insight

Notes

Submitted from the public SkillSpec Doctor page.

[github-actions]

SkillSpec Doctor report

Target: github.com/eclipse-cyclonedds/cyclonedds-insight

Shape: non_skill_repository - no SKILL.md entrypoint was discovered; doctor stopped before source-map parsing

Status: shape_only

Remote: github.com/eclipse-cyclonedds/cyclonedds-insight.git

What This Measures

Doctor estimates how likely an agent is to miss, reorder, improvise, use the wrong surface, or finish without proof because of the current skill shape.

This is a baseline of the current skill shape at doctor time. It is not a grade of domain knowledge, human usefulness, author effort, or legal/medical correctness.

Higher risk means a higher chance the agent skips, reorders, or improvises load-bearing instructions.

Current Skill Baseline

• Verdict: shape-only: full single-skill doctor not run
• Follow-through readiness: not evaluated
• Agent follow-through risk: not evaluated (shape_only)

Surface

• Activation body: 0 line(s), 0 byte(s), approximately 0 token(s)
• Deferred resources: 0 file(s), 0 byte(s)
• Frontmatter: 0 line(s), 0 byte(s)
• Activation-loaded surface: 0%
• Unmapped package files: 0
• Instruction signals: 0 modal obligation(s), 0 late obligation(s), 0 numbered step(s), 0 dependency mention(s)
• Code in active skill: 0 block(s), 0 unlabeled

Shape Details

Negative Signals

• no SKILL.md discovered under the target
• code-like repository surface detected: 52 code file(s), 2 manifest file(s)

Findings

1. HIGH: Target is not shaped like an agent skill

Location: github.com/eclipse-cyclonedds/cyclonedds-insight

Evidence: No SKILL.md was found. Static inventory saw 1 Markdown file(s), 52 code file(s), and 2 manifest file(s).

Basis: contract_trace_static_well_formedness

Fix: Pass a folder containing SKILL.md, a GitHub skill folder URL, or add a SKILL.md entrypoint before running doctor.

Next Actions

Recommended next action

Pass a skill folder or add SKILL.md before running skillspec doctor

• Stop here: doctor did not find a SKILL.md entrypoint.
• Select a folder that contains SKILL.md, pass a GitHub skill-folder URL, or add a SKILL.md before importing.
• Do not run import or workspace fanout against an ordinary code repository until a skill entrypoint exists.

Research Basis

17 cited basis item(s) are attached to this report.

• reliability_gap_instruction_density - Large, dense activation bodies increase dropped-step risk and later instructions suffer primacy bias. (SkillSpec Skills Reliability Gap)
• reliability_gap_metadata_context_pressure - Skill frontmatter metadata and activated bodies consume context; broad surfaces degrade routing and adherence. (SkillSpec Skills Reliability Gap)
• reliability_gap_implicit_environment_contract - Scripts and snippets carry dependency contracts whether or not the skill declares them. (SkillSpec Skills Reliability Gap)
• reliability_gap_no_execution_guarantees - Prose instructions and embedded snippets are guidance unless moved into checkable or enforced surfaces. (SkillSpec Skills Reliability Gap)
• reliability_gap_unfilled_requirement - Reliable skills need a portable, machine-checkable account of intended behavior, dependencies, and proof. (SkillSpec Skills Reliability Gap)
• contract_trace_activation_adherence_enforcement - Activation, adherence, and enforcement are separate gates; static prose mostly influences adherence, not enforcement. (SkillSpec Contract Trace Methodology)
• 11 more basis item(s) omitted. Use --json for the full basis registry.

Use --html for a shareable review page or --json for machine evidence.

Full artifacts: https://github.com/modiqo/skillspec/actions/runs/28358432222/artifacts/7946286979

The artifact contains:

• doctor-report.txt
• doctor-report.md
• doctor-report.html
• doctor-report.json
• target.txt