@@ -58,10 +58,6 @@ token count, plus overall metadata usage. I've used and tested them most with
branch lives in its own sibling directory. Requires [wt], git, and [gum].
- [notifying-through-ntfy](skills/notifying-through-ntfy/SKILL.md): Sends push
notifications via [ntfy.sh] when requested, such as at the end of its turn.
-- [querying-documentation](skills/querying-documentation/SKILL.md): Query Go
- documentation with focused subagents for complex questions spanning multiple
- packages or external libraries. Requires Fish shell and [synu]. Currently
- Go-only.
- [rebasing-with-git](skills/rebasing-with-git/SKILL.md): Manages git rebase workflows
from simple rebases to the drop-and-repick integration branch pattern. Assumes
`upstream` remote for forks and `rerere` enabled. Supports worktrees including
@@ -1,31 +0,0 @@
----
-name: querying-documentation
-description: Spawns a focused subagent to query language/framework documentation. Use for complex questions requiring exploration across multiple symbols, external library APIs, or understanding how to combine types from different packages. Currently supports Go; more doc sets may be added later.
-compatibility: Requires Fish and synu Fish plugin
-license: AGPL-3.0-or-later
-metadata:
- author: Amolith <amolith@secluded.site>
----
-
-Invoke with `fish path/to/skills/querying-documentation/scripts/query.fish -s <set> '<query>'`. Use the absolute path so you can run it from the project directory where `go doc` will work.
-
-Run with `-h` to see available doc sets.
-
-These agents have restricted tool access—they can only query docs, not read files or search the web. Write thorough questions that justify the cost; simple lookups you can answer with `go doc` yourself.
-
-## Examples
-
-```bash
-# Combining stdlib with external library
-fish path/to/skills/querying-documentation/scripts/query.fish -s go 'How would I use golang.org/x/sync/errgroup together with context.WithCancel to run parallel HTTP requests that all cancel if any fails?'
-
-# Understanding relationships across an external library
-fish path/to/skills/querying-documentation/scripts/query.fish -s go 'In github.com/charmbracelet/bubbletea, how do Model, Cmd, and Msg relate? What does Update return and why?'
-
-# Exploring implementation patterns
-fish path/to/skills/querying-documentation/scripts/query.fish -s go 'How do the io.Reader wrappers (bufio.Reader, io.LimitReader, io.TeeReader) compose? Show how to chain them for reading a limited, buffered copy of a stream.'
-```
-
----
-
-Refer to [dependencies.md](references/dependencies.md) if dependencies are missing.
@@ -1,85 +0,0 @@
-function doc-agent --description "Invoke Synclaude as a documentation-focused sub-agent"
- # Define available docsets
- set -l available_sets go
-
- # Docset: go
- set -l go_tools "go doc"
- set -l go_allowed_tools "Bash(go doc:*)"
- # These aren't global because WebFetch might be useful later for
- # obtaining docs from pages that don't have CLI tooling
- set -l go_disallowed_tools "Bash(*) Explore Edit Read WebFetch WebSearch Glob Grep NotebookEdit NotebookRead SlashCommand Task Write"
- set -l go_usage "\
-Looking up Go stdlib, types, functions, methods, interfaces, or third-party \
-package APIs, asking about usage, combining functions from across APIs, etc."
- set -l go_system_prompt "\
-You are a focused documentation agent for Go. Use 'go doc' to look up \
-information about Go packages, types, functions, methods, and other symbols. \
-Look at specific symbols rather than reading entire packages unless necessary \
-to understand context. Answer queries thoroughly. You are disallowed from \
-running any tool but Bash to execute `go doc` subcommands. You _must_ use\
-`go doc` to answer the query and nothing else."
-
- argparse 'h/help' 's/set=' 'm/model=' -- $argv
- or return 1
-
- # Show help if requested
- if set -q _flag_help
- echo "Usage: doc-agent -s <set> '<query>'"
- echo
- echo "Options:"
- echo " -s, --set Documentation set to use (required)"
- echo " -h, --help Show this help message"
- echo
- echo "Available documentation sets:"
- echo
-
- for docset in $available_sets
- set -l tools_var "$docset"_tools
- set -l usage_var "$docset"_usage
-
- echo "- $docset"
- echo " - Allowed tools: $$tools_var"
- echo " - When to use: $$usage_var" | fold -s -w 78 | sed '1!s/^/ /'
- echo
- end
-
- echo "Tips:"
- echo "- Encourage looking at specific symbols rather than entire"
- echo " packages unless context requires it."
- echo "- The doc-agent will only have access to its specific"
- echo " documentation tools; it can't read files, search the web, etc."
- return 0
- end
-
- # Validate required arguments
- if not set -q _flag_set
- echo "Error: --set/-s is required" >&2
- echo "Run 'doc-agent -h' for usage information" >&2
- return 1
- end
-
- # Validate docset exists
- if not contains $_flag_set $available_sets
- echo "Error: unknown documentation set '$_flag_set'" >&2
- echo "Run 'doc-agent -h' to see available sets" >&2
- return 1
- end
-
- # Configure the doc set
- switch $_flag_set
- case go
- set allowed_tools $go_allowed_tools
- set disallowed_tools $go_disallowed_tools
- set system_prompt $go_system_prompt
-
- case '*'
- echo "Error: unknown documentation set '$_flag_set'" >&2
- return 1
- end
-
- synu claude -H "hf:zai-org/GLM-4.7" -l "hf:zai-org/GLM-4.7" --model sonnet \
- --allowed-tools "$allowed_tools" \
- --disallowed-tools "$disallowed_tools" \
- --append-system-prompt "$system_prompt" \
- -p $argv
-end