tunacode-cli 0.1.84__tar.gz → 0.1.86__tar.gz

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/JOURNAL.md

@@ -1,3 +1,11 @@
+---
+title: "Claude Journal"
+type: metadata
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: 4a225704-c3d4-4afb-9a94-17247607864e
+---
+
 # Claude Journal
 
 ## 2026-01-21: pydantic-ai System Prompt Stripping Fix (Branch: resume-qa)

tunacode_cli-0.1.86/.claude/debug_history/2026-03-06-command-autocomplete-argument-interference.md

@@ -0,0 +1,33 @@
+---
+title: Slash-command autocomplete intercepted `/skills` argument navigation
+link: command-autocomplete-argument-interference
+type: bugfix
+path: src/tunacode/ui/widgets/command_autocomplete.py
+tags:
+  - ui
+  - autocomplete
+  - commands
+  - skills
+created_at: 2026-03-06T22:35:00-06:00
+updated_at: 2026-03-06T22:35:00-06:00
+---
+
+## Summary
+
+Fixed the root cause of broken `/skills` navigation: the generic slash-command autocomplete was still building candidates while the user was editing command arguments, so arrow and Enter keys could be consumed by the wrong dropdown.
+
+## Trigger
+
+Typing `/skills ...` correctly opened the skills dropdown, but pressing Down caused the hidden slash-command autocomplete to activate and move its own highlight. Enter could then complete `/cancel`, `/compact`, or another slash command instead of the highlighted skill.
+
+## Changes
+
+- Tightened `CommandAutoComplete.get_candidates()` to return candidates only while the user is editing the command-name region before the first space.
+- Reused the same command-name parser already used by visibility logic.
+- Added focused tests proving command autocomplete is inactive during `/skills` argument editing.
+- Added an end-to-end headless UI test proving `/skills ` + Down + Enter selects the highlighted skill, not a slash command.
+
+## Tests
+
+- `uv run pytest tests/unit/ui/test_command_autocomplete.py tests/unit/ui/test_skills_autocomplete.py -q`
+- `uv run ruff check src/tunacode/ui/widgets/command_autocomplete.py tests/unit/ui/test_command_autocomplete.py tests/unit/ui/test_skills_autocomplete.py`

tunacode_cli-0.1.86/.claude/debug_history/2026-03-06-skills-autocomplete-selection-ranking.md

@@ -0,0 +1,34 @@
+---
+title: Skills autocomplete selected the wrong skill for short prefixes
+link: skills-autocomplete-selection-ranking
+type: bugfix
+path: src/tunacode/ui/widgets/skills_autocomplete.py
+tags:
+  - skills
+  - ui
+  - autocomplete
+  - ranking
+created_at: 2026-03-06T22:15:00-06:00
+updated_at: 2026-03-06T22:15:00-06:00
+---
+
+## Summary
+
+Fixed `/skills` autocomplete so short prefixes now prefer the best semantic skill match instead of an arbitrary fuzzy-match winner.
+
+## Trigger
+
+Typing `/skills de` and pressing Enter selected `dead-code-detector` ahead of `demo`, even though `demo` was the more specific prefix match the user intended.
+
+## Changes
+
+- Added `src/tunacode/skills/search.py` with deterministic skill-match ordering.
+- Ranked exact name matches before prefix matches, prefix matches before substring matches, and description matches last.
+- Broke prefix ties by shorter skill name first so concise exact-prefix skills win.
+- Updated `SkillsAutoComplete` to preserve the candidate order it computes instead of letting fuzzy scoring reshuffle the dropdown.
+- Updated `/skills` catalog filtering to use the same ordering logic as autocomplete.
+
+## Tests
+
+- Added unit coverage for skill ranking behavior.
+- Added a headless TUI test proving `/skills de` + Enter selects `demo`, then Enter loads it.

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/debug_history/context-loss-bug.md

@@ -1,3 +1,11 @@
+---
+title: "Bug: Messages Not Persisted on Error/Abort"
+type: debug
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: b2f4d4fd-7e70-48d8-b326-92bd9b697299
+---
+
 # Bug: Messages Not Persisted on Error/Abort
 
 ## Summary

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/debug_history/continuous-learning.md

@@ -1,3 +1,11 @@
+---
+title: "Continuous Learning Log"
+type: debug
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: c21d2cfb-ed4a-4e47-a355-d05f4220c73f
+---
+
 # Continuous Learning Log
 
 Bugs, smells, issues dumped here as encountered. Raw is fine. A skill will organize this into proper kb entries later.

tunacode_cli-0.1.86/.claude/delta/2026-03-06-github-release-pypi-skip-existing.md

@@ -0,0 +1,16 @@
+---
+title: "GitHub release publish workflow: skip existing PyPI artifacts"
+type: delta
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: ba502a45-cae9-4026-8c3c-a4167ad8213b
+---
+
+# GitHub release publish workflow: skip existing PyPI artifacts
+
+## Summary
+- Updated `.github/workflows/publish-release.yml` to use `twine upload --skip-existing`.
+- This allows a GitHub Release to be published after a manual PyPI upload without failing on duplicate distributions.
+
+## Reasoning
+`v0.1.84` was already uploaded to PyPI manually. Publishing the matching GitHub Release triggers the PyPI workflow, so the workflow must tolerate already-published artifacts.

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/delta/2026-03-06-pypi-release-0.1.84.md

@@ -1,3 +1,11 @@
+---
+title: "PyPI release 0.1.84"
+type: delta
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: 49c56f85-1b52-4822-93b4-d9034bb606f5
+---
+
 # PyPI release 0.1.84
 
 ## Summary

tunacode_cli-0.1.86/.claude/delta/2026-03-06-pypi-release-0.1.85.md

@@ -0,0 +1,23 @@
+---
+title: "PyPI release 0.1.85"
+type: delta
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: 0041fe28-4575-41b9-844a-25490259d330
+---
+
+# PyPI release 0.1.85
+
+## Summary
+- Bumped the packaged TunaCode version from `0.1.84` to `0.1.85`.
+- Synced release metadata in `pyproject.toml`, `src/tunacode/constants.py`, and `uv.lock`.
+- Added a changelog entry for the `/skills` autocomplete ranking fix and the slash-command argument isolation fix.
+
+## Files
+- `pyproject.toml`
+- `src/tunacode/constants.py`
+- `uv.lock`
+- `CHANGELOG.md`
+
+## Reasoning
+A new patch release was needed because `master` contains user-facing fixes for `/skills` selection and navigation after `v0.1.84`, while the current PyPI package still published the broken behavior.

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/metadata/pydantic_runtime_removal_attempt.md

@@ -1,3 +1,11 @@
+---
+title: "Pydantic Runtime Removal Attempt (PR #334, closed)"
+type: metadata
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: a9f2df2c-54b1-49a6-878b-2c42f4c145be
+---
+
 # Pydantic Runtime Removal Attempt (PR #334, closed)
 
 Date: 2026-01-31

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/metadata/research/2026-02-01-glob-text-match-research.md

@@ -1,3 +1,11 @@
+---
+title: "Research – Glob filesystem search_sync and block_anchor_replacer"
+type: metadata
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: 6122c5dd-c84e-4897-9265-ecb66b3d28e5
+---
+
 # Research – Glob filesystem search_sync and block_anchor_replacer
 **Date:** 2026-02-01
 **Phase:** Research

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/metadata/research/2026-02-12-tinyagent-rust-only-migration-map.md

@@ -1,3 +1,11 @@
+---
+title: "Research – TunaCode tinyagent Rust-only stream mapping"
+type: metadata
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: 421d2204-3f76-4437-95f8-f815a89c692e
+---
+
 # Research – TunaCode tinyagent Rust-only stream mapping
 **Date:** 2026-02-12
 **Phase:** Research

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/qa/raw.md

@@ -1,3 +1,11 @@
+---
+title: "Raw"
+type: qa
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: c92b78e9-9d66-47a3-8c86-d5661a82e0c2
+---
+
 [2026-01-15] [bug] message history missed tool-return when request ended early; fix by persisting agent_run.all_messages and keeping system notices out of history.
 [2026-01-16] [bug] tool panels rendered to the RichLog content region width; fix by setting explicit panel frame width from max_line_width plus TOOL_PANEL_HORIZONTAL_INSET.
 [2026-01-21] [bug] dangling tool calls could persist mid-history and stall the API; fix by scanning all messages for unmatched tool calls and removing them.

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/task/task_01_canonical_messaging_adoption.md

@@ -1,3 +1,11 @@
+---
+title: "Task 01: Canonical Messaging Adoption"
+type: task
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: f71c2309-4adf-4ee1-803c-02b5db1d9258
+---
+
 # Task 01: Canonical Messaging Adoption
 
 ## Status: COMPLETE ✓

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/task/task_02_session_state_decomposition.md

@@ -1,3 +1,11 @@
+---
+title: "Task 02: SessionState Decomposition"
+type: task
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: cf299522-eb4f-41df-a153-a4e24bf9fdfd
+---
+
 # Task 02: SessionState Decomposition
 
 ## Status: PENDING

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/task/task_03_message_parity_harness.md

@@ -1,3 +1,11 @@
+---
+title: "Task 03: Message Parity Harness"
+type: task
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: 126e3844-6c64-4499-9ce9-229beddb09e1
+---
+
 # Task 03: Message Parity Harness
 
 ## Summary

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/task/task_04_canonical_sanitization.md

@@ -1,3 +1,11 @@
+---
+title: "Task 04: Canonical Sanitization"
+type: task
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: eaa5370f-cc3f-4dd3-a14d-58e86eb132a4
+---
+
 # Task 04: Canonical Sanitization
 
 ## Summary

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/task/task_05_tool_call_registry_ownership.md

@@ -1,3 +1,11 @@
+---
+title: "Task 05: Tool Call Registry Ownership"
+type: task
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: 4736f7b4-04b7-4579-a024-337fc5f5f2a9
+---
+
 # Task 05: Tool Call Registry Ownership
 
 ## Summary

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/task/task_06_react_state_alignment.md

@@ -1,3 +1,11 @@
+---
+title: "Task 06: ReAct State Alignment"
+type: task
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: c3569ebb-2b37-412e-8acb-638581d8107f
+---
+
 # Task 06: ReAct State Alignment
 
 ## Summary

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/task/task_07_todo_state_alignment.md

@@ -1,3 +1,11 @@
+---
+title: "Task 07: Todo State Alignment"
+type: task
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: 22c1a005-1d86-4f59-a6e4-4e115237bcd8
+---
+
 # Task 07: Todo State Alignment
 
 ## Summary

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/task/task_08_usage_metrics_consolidation.md

@@ -1,3 +1,11 @@
+---
+title: "Task 08: Usage Metrics Consolidation"
+type: task
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: f99bc665-7a0e-4e56-a024-082111553c81
+---
+
 # Task 08: Usage Metrics Consolidation
 
 ## Summary

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/task/task_09_architecture_enforcement_tests.md

@@ -1,3 +1,11 @@
+---
+title: "Task 09: Architecture Enforcement Tests"
+type: task
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: f100ac1a-f5f7-4795-8fcf-66e5386bc9a7
+---
+
 # Task 09: Architecture Enforcement Tests
 
 ## Summary

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.claude/task/task_10_legacy_path_decommission.md

@@ -1,3 +1,11 @@
+---
+title: "Task 10: Legacy Path Decommission"
+type: task
+created_at: 2026-03-06T05:18:58Z
+updated_at: 2026-03-06T05:18:58Z
+uuid: 84d799c0-b1df-4cc0-9930-e66f5f00e41e
+---
+
 # Task 10: Legacy Path Decommission
 
 ## Summary

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/.github/workflows/publish-release.yml

@@ -66,8 +66,8 @@ jobs:
         run: python -m build
 
       # Preferred: API token secret
-      - name: Publish to PyPI (API token)
+      - name: Publish to PyPI (API token, skip existing)
         env:
           TWINE_USERNAME: __token__
           TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
-        run: python -m twine upload dist/*
+        run: python -m twine upload --skip-existing dist/*

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.86] - 2026-03-06
+
+### Added
+- Introduced prompt context injection for actively loaded skills so selected skill guidance is surfaced to the agent runtime.
+
+### Changed
+- Refined skills UI styling and load behavior to improve local/global skill discovery ergonomics.
+
+### Fixed
+- Resolved selected-skill path handling to use discovered absolute paths reliably across local and global skill locations.
+- Included absolute skill paths in prompt context to prevent path-resolution drift when rendering skill metadata.
+
+## [0.1.85] - 2026-03-06
+
+### Fixed
+- Made `/skills` autocomplete prefer the most relevant skill match instead of fuzzy-reordering short prefixes.
+- Isolated slash-command autocomplete to command names so `/skills` navigation and Enter selection no longer get hijacked by hidden command suggestions.
+
 ## [0.1.84] - 2026-03-06
 
 ### Fixed

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tunacode-cli
-Version: 0.1.84
+Version: 0.1.86
 Summary: Your agentic CLI developer.
 Project-URL: Homepage, https://tunacode.xyz/
 Project-URL: Repository, https://github.com/alchemiststudiosDOTai/tunacode

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 [project]
 name = "tunacode-cli"
 
-version = "0.1.84"
+version = "0.1.86"
 description = "Your agentic CLI developer."
 keywords = ["cli", "agent", "development", "automation"]
 readme = "README.md"

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/src/tunacode/constants.py

@@ -18,7 +18,7 @@ KB = 1024
 MB = KB * 1024
 
 APP_NAME = "TunaCode"
-APP_VERSION = "0.1.84"
+APP_VERSION = "0.1.86"
 
 
 GUIDE_FILE_NAME = "AGENTS.md"

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/src/tunacode/prompts/system_prompt.md

@@ -61,6 +61,14 @@ You MUST reuse paths exactly as returned by discover.
 - When asked to teach, teach first, then test.
 - If a tool call is rejected, acknowledge, adjust approach, and do not retry the same call.
 - If a response is truncated, continue to completion.
+
+###Loaded Skills###
+- If the prompt includes a `# Selected Skills` section, those skills were explicitly loaded by the user and are ACTIVE for the current session.
+- Active loaded skills are operating instructions, not optional background reading.
+- Before searching the repo for guidance, inspect the loaded skill material and the absolute skill paths provided in that section.
+- If a loaded skill applies to the task, you MUST use it even if the user does not repeat the skill name.
+- When a loaded skill affects your plan or answer, explicitly state that the skill is loaded and being used.
+- Skill files may live outside the current working directory; use the absolute skill paths provided in prompt context.
 </instructions>
 
 <examples>

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/src/tunacode/skills/loader.py

@@ -39,6 +39,18 @@ PATH_SUFFIXES = {
 }
 URL_PREFIXES = ("http://", "https://")
 DISALLOWED_REFERENCE_PREFIXES = ("#", "/", "~")
+EXCLUDED_RELATED_PATH_PARTS = {
+    ".git",
+    ".mypy_cache",
+    ".pytest_cache",
+    ".ruff_cache",
+    ".venv",
+    "__pycache__",
+    "node_modules",
+    "venv",
+}
+EXCLUDED_RELATED_FILE_NAMES = {".DS_Store"}
+EXCLUDED_RELATED_FILE_SUFFIXES = {".pyc"}
 
 
 class SkillLoadError(RuntimeError):
@@ -101,6 +113,18 @@ def load_skill(discovered_skill: DiscoveredSkillPath) -> LoadedSkill:
     )
 
 
+def list_skill_related_paths(skill_dir: Path, *, skill_path: Path) -> tuple[Path, ...]:
+    """Return deterministic absolute paths for non-SKILL files under a skill directory."""
+
+    resolved_skill_path = skill_path.resolve()
+    related_paths = [
+        path.resolve()
+        for path in skill_dir.rglob("*")
+        if _should_include_related_path(path, resolved_skill_path)
+    ]
+    return tuple(sorted(set(related_paths), key=lambda path: str(path).casefold()))
+
+
 def _load_parsed_skill_document(discovered_skill: DiscoveredSkillPath) -> _ParsedSkillDocument:
     raw_content = _read_skill_file(discovered_skill.skill_path)
     if _starts_with_frontmatter(raw_content):
@@ -296,6 +320,23 @@ def _find_recursive_reference_matches(skill_dir: Path, file_name: str) -> list[P
     return sorted(set(matching_paths))
 
 
+def _should_include_related_path(path: Path, skill_path: Path) -> bool:
+    if not path.is_file():
+        return False
+
+    resolved_path = path.resolve()
+    if resolved_path == skill_path:
+        return False
+
+    if resolved_path.name in EXCLUDED_RELATED_FILE_NAMES:
+        return False
+
+    if resolved_path.suffix.lower() in EXCLUDED_RELATED_FILE_SUFFIXES:
+        return False
+
+    return not any(part in EXCLUDED_RELATED_PATH_PARTS for part in resolved_path.parts)
+
+
 def _iter_reference_candidates(content: str) -> list[str]:
     candidates: list[str] = []
     for match in MARKDOWN_LINK_PATTERN.finditer(content):

{tunacode_cli-0.1.84 → tunacode_cli-0.1.86}/src/tunacode/skills/models.py

@@ -42,6 +42,9 @@ class SelectedSkill:
 
     name: str
     source: SkillSource
+    skill_dir: Path
     skill_path: Path
+    referenced_paths: tuple[Path, ...]
+    related_paths: tuple[Path, ...]
     content: str
     attachment_index: int

tunacode_cli-0.1.86/src/tunacode/skills/prompting.py

@@ -0,0 +1,123 @@
+from __future__ import annotations
+
+import hashlib
+from collections.abc import Iterable
+from pathlib import Path
+
+from tunacode.skills.models import SelectedSkill, SkillSummary
+
+AVAILABLE_SKILLS_SECTION_TITLE = "# Available Skills"
+SELECTED_SKILLS_SECTION_TITLE = "# Selected Skills"
+
+SELECTED_SKILLS_INSTRUCTION = """\
+The user explicitly loaded the following skills via /skills, and they are ACTIVE for this session.
+These loaded skills are not optional reference material; they are active operating instructions.
+Before doing work, determine whether one or more loaded skills apply to the user's request.
+If a loaded skill applies, you MUST follow it,
+even if the user does not repeat its name in the latest message.
+When a loaded skill is relevant,
+prefer its workflow and guidance over generic default behavior.
+Before searching the repository for help,
+check the loaded skill paths below and use them directly when they are relevant.
+You MUST read each loaded skill's full SKILL.md content
+and use the exact absolute skill paths below as authoritative.
+These skill files may live outside the current project working directory.
+Do not assume searching only the repo root will find them.
+When a loaded skill materially affects your answer or plan,
+explicitly say that the skill is loaded and being used.
+Do not ignore a loaded skill that matches the task."""
+
+SKILL_STATUS_LABEL = "Skill status"
+SKILL_DIRECTORY_LABEL = "Skill directory (absolute)"
+SKILL_FILE_LABEL = "Skill definition file (absolute)"
+SKILL_REFERENCED_FILES_LABEL = "Files explicitly referenced by SKILL.md"
+SKILL_RELATED_FILES_LABEL = "Other files available in the skill directory"
+SKILL_CONTENT_LABEL = "Full SKILL.md content"
+EMPTY_PATH_LIST_LABEL = "(none)"
+
+
+def render_available_skills_block(skill_summaries: list[SkillSummary]) -> str:
+    lines = ["", "", AVAILABLE_SKILLS_SECTION_TITLE]
+    if not skill_summaries:
+        lines.append("(none)")
+        return "\n".join(lines)
+
+    for skill_summary in skill_summaries:
+        lines.append(f"- {skill_summary.name}: {skill_summary.description}")
+    return "\n".join(lines)
+
+
+def render_selected_skills_block(selected_skills: list[SelectedSkill]) -> str:
+    if not selected_skills:
+        return ""
+
+    lines = ["", "", SELECTED_SKILLS_SECTION_TITLE]
+    lines.append(SELECTED_SKILLS_INSTRUCTION)
+    lines.append("")
+    for selected_skill in selected_skills:
+        _append_selected_skill_block(lines, selected_skill)
+    return "\n".join(lines)
+
+
+def _append_selected_skill_block(lines: list[str], selected_skill: SelectedSkill) -> None:
+    lines.append(f"## {selected_skill.name} ({selected_skill.source.value})")
+    lines.append(f"{SKILL_STATUS_LABEL}: ACTIVE - explicitly loaded by the user via /skills")
+    lines.append(f"{SKILL_DIRECTORY_LABEL}: {selected_skill.skill_dir}")
+    lines.append(f"{SKILL_FILE_LABEL}: {selected_skill.skill_path}")
+    lines.append(
+        "This skill is active right now. "
+        "Use these absolute paths directly when you need skill files."
+    )
+    lines.append(f"{SKILL_REFERENCED_FILES_LABEL}:")
+    _append_path_list(lines, selected_skill.referenced_paths)
+
+    additional_related_paths = [
+        path for path in selected_skill.related_paths if path not in selected_skill.referenced_paths
+    ]
+    lines.append(f"{SKILL_RELATED_FILES_LABEL}:")
+    _append_path_list(lines, additional_related_paths)
+
+    lines.append("")
+    lines.append(f"{SKILL_CONTENT_LABEL}:")
+    lines.append(selected_skill.content)
+    lines.append("")
+
+
+def _append_path_list(lines: list[str], paths: Iterable[Path]) -> None:
+    materialized_paths = list(paths)
+    if not materialized_paths:
+        lines.append(f"- {EMPTY_PATH_LIST_LABEL}")
+        return
+
+    for path in materialized_paths:
+        lines.append(f"- {path}")
+
+
+def compute_skills_prompt_fingerprint(
+    skill_summaries: list[SkillSummary],
+    selected_skills: list[SelectedSkill],
+) -> str:
+    fingerprint_parts: list[str] = []
+
+    for skill_summary in skill_summaries:
+        fingerprint_parts.append(
+            f"summary:{skill_summary.name}:{skill_summary.description}:{skill_summary.source.value}"
+        )
+
+    for selected_skill in selected_skills:
+        content_hash = hashlib.sha256(selected_skill.content.encode("utf-8")).hexdigest()
+        referenced_paths_hash = _hash_paths(selected_skill.referenced_paths)
+        related_paths_hash = _hash_paths(selected_skill.related_paths)
+        fingerprint_parts.append(
+            "selected:"
+            f"{selected_skill.name}:{selected_skill.source.value}:{selected_skill.skill_dir}:"
+            f"{selected_skill.skill_path}:{content_hash}:{referenced_paths_hash}:{related_paths_hash}"
+        )
+
+    fingerprint_input = "|".join(fingerprint_parts)
+    return hashlib.sha256(fingerprint_input.encode("utf-8")).hexdigest()
+
+
+def _hash_paths(paths: Iterable[Path]) -> str:
+    joined_paths = "|".join(str(path) for path in paths)
+    return hashlib.sha256(joined_paths.encode("utf-8")).hexdigest()