Bug Description

The Flash Attention optional-skill documentation links to two reference files that are not present.

In optional-skills/mlops/flash-attention/SKILL.md, these links are listed:

• [references/algorithm.md](references/algorithm.md)
• [references/advanced-features.md](references/advanced-features.md)

But both target files are missing from optional-skills/mlops/flash-attention/references/.

This creates dead links in the skill documentation flow.

Steps to Reproduce

1. Open optional-skills/mlops/flash-attention/SKILL.md.
2. Locate the references to references/algorithm.md and references/advanced-features.md (near the end of the file).
3. List files in optional-skills/mlops/flash-attention/references/.
4. Observe only benchmarks.md and transformers-integration.md exist.
5. Confirm algorithm.md and advanced-features.md are missing.

Expected Behavior

All linked reference files in the skill should exist, or links should be removed/updated.

Actual Behavior

SKILL.md links to two reference files that do not exist.

Affected Component

• Skills (skill loading, skill hub, skill guard)
• Other (optional-skill documentation references)

Messaging Platform (if gateway-related)

• N/A (CLI only)

Debug Report

N/A — static documentation/reference consistency issue.

Operating System

N/A (repository content issue)

Python Version

N/A

Hermes Version

N/A

Additional Logs / Traceback (optional)

None.

Root Cause Analysis (optional)

Documentation/reference drift in the Flash Attention optional skill:

• Referencing file: optional-skills/mlops/flash-attention/SKILL.md
• Missing targets:
  • optional-skills/mlops/flash-attention/references/algorithm.md
  • optional-skills/mlops/flash-attention/references/advanced-features.md

Proposed Fix (optional)

Maintainer choice:

1. Add the missing reference files, or
2. Remove/update the broken links in SKILL.md.

Are you willing to submit a PR for this?

Yes — happy to submit a focused docs PR after maintainer preference is clear.