fix: skill prompt covers both .graph and three-file formats

[jonathanpopham]

The skill prompt only mentioned .calls/.deps/.impact files. Users running without --three-file get single .graph files and the prompt didn't tell the agent about them.

Now covers both formats with a note that three-file is recommended.

Summary by CodeRabbit

• Documentation
  • Updated help text describing support for multiple graph file formats, including both single-file and distributed layouts. Navigation guidance adjusted to reflect available file format options.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

Walkthrough

The PR updates the help text for a skill command to document two different ways graph-shard data can be organized: either as a single .graph.* file with internal sections, or as three separate files. The instructions now prioritize the three-file approach but gracefully fall back to the single file.

Changes

Cohort / File(s)	Summary
Graph-shard Documentation cmd/skill.go	Updated skillPrompt string to describe dual support for single-file (.graph.* with [deps], [calls], [impact] sections) and three-file (.calls.*, .deps.*, .impact.*) layouts, with preference logic favoring the three-file format when available.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

• feat: add supermodel skill command for agent awareness prompt #119 — Originally introduced the skillPrompt and three-file shard support; this PR extends it to also document the single-file .graph.* format as an alternative.

Suggested reviewers

• greynewell

Poem

📋 Two formats, one command,
Shards unified or single-banded,
Flexibility takes the stand,
Your data flows as you've planned! ✨

🚥 Pre-merge checks | ✅ 1 | ❌ 2

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description lacks the required template structure with sections for What, Why, and Test plan; it only provides informal context without the checkbox items specified.	Restructure the description to follow the template: add clear 'What', 'Why', and 'Test plan' sections with checkboxes for make test, make lint, and manual testing steps.
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (1 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely summarizes the main change: updating the skill prompt to cover both .graph and three-file formats.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[jonathanpopham]

Superseded by #122 (full revert). Skill command needs redesign.