Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion dotfiles/claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

When implementing features or fixing bugs, follow the strict TDD practices defined in:

@~/.claude/custom-snippets/strict-tdd-guide.md
~/.claude/custom-snippets/strict-tdd-guide.md

## Descriptive variables
Always use human-readable, descriptive variables.
Expand Down
34 changes: 34 additions & 0 deletions dotfiles/claude/skills/lookup-docs/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
---
name: lookup-docs
description: Load reference documentation from ~/.claude/context/reference-docs/ before answering questions. Use when user asks to consult specific docs (e.g., argo-cd, kubernetes).
---

# Reference Documentation Lookup

You have been instructed to consult reference documentation before answering the user's question.

## Workflow

1. **Identify the documentation topic** from the user's request (e.g., "argo-cd", "kubernetes")

2. **Search local reference docs** at `~/.claude/context/reference-docs/<topic>/`
- Use Grep to find files containing keywords from the user's question
- Prioritize files whose names suggest relevance

3. **Load relevant documentation**
- Read the 1-4 most relevant files
- If the docs are large, use targeted searches within them

4. **If not found locally**
- Report that the docs aren't available in `~/.claude/context/reference-docs/`
- Ask if the user wants you to: proceed without the docs, lookup docs online, wait for the user to add the docs to the reference folder, or some other approach

5. **Answer the original question**
- Synthesize information from the loaded docs
- Cite specific sections/files when possible
- If docs don't fully answer the question, note what's missing

## Important
- This skill loads docs into context, then you continue the conversation
- Don't just summarize docs - answer the specific question asked
- Reference file paths when citing information
8 changes: 3 additions & 5 deletions scripts/claude.sh
Original file line number Diff line number Diff line change
Expand Up @@ -104,8 +104,6 @@ symlink_preferences() {
done
}

<<<<<<< HEAD
=======
symlink_skills() {
local dotfiles_claude_dir="$1"
local source_skills_dir="$dotfiles_claude_dir/skills"
Expand All @@ -125,8 +123,11 @@ symlink_skills() {
create_symlink_if_needed "$skill_item" "$target_skills_dir/$item_name"
done
}
<<<<<<< HEAD

>>>>>>> 2bc28bb6d1d387013755edb33725a17d06a9ee42
=======
>>>>>>> fbcc70b (Add a lookup-docs skill)
main() {
ensure_claude_directory_initialized

Expand All @@ -143,10 +144,7 @@ main() {
symlink_custom_snippets "$dotfiles_claude_dir"
symlink_claude_md "$dotfiles_claude_dir"
symlink_preferences "$dotfiles_claude_dir"
<<<<<<< HEAD
=======
symlink_skills "$dotfiles_claude_dir"
>>>>>>> 2bc28bb6d1d387013755edb33725a17d06a9ee42

echo "Done!"
}
Expand Down