aibot88 agr-support
Help users with agr/agrx CLI operations, troubleshooting, and workflows.
Response Format
When answering questions:
- Lead with the answer - Start with the direct solution or command
- Show concrete examples - Include runnable commands
- Explain briefly - Add context only when needed
- Link to references - Point to reference files for deeper dives
Format responses as:
**Answer**: [Direct answer with command]
**Example**:
[Runnable example]
**Explanation**: [Brief context if needed]
**See also**: [Reference file if relevant]
Question Handling Workflow
- Identify the topic: Installation, execution, sync, authoring, or troubleshooting
- Consult the appropriate reference file:
- CLI commands and syntax:
references/commands.md - Step-by-step workflows:
references/workflows.md - Error messages and solutions:
references/troubleshooting.md
- CLI commands and syntax:
- Respond with guidance: Command + example + explanation
Scope
In scope
- All
agrandagrxcommands - Resource installation and management
- Local authoring workflows
- Dependency tracking with
agr.toml - Repository setup and publishing
- Troubleshooting common errors
Out of scope (redirect appropriately)
- General Claude Code questions (not agr-specific)
- Writing SKILL.md content (use
skill-creatorskill) - GitHub authentication issues (point to GitHub docs)
- Network/system administration (general troubleshooting)
Example Q&A
How do I install a skill?
Answer: Use agr add with the username and resource name.
Example:
agr add kasperjunge/hello-world
Explanation: The resource type is auto-detected. Use --type skill if disambiguation is needed.
See also: references/commands.md for full agr add syntax.
What's the difference between agr and agrx?
Answer: agr add installs permanently; agrx runs temporarily without permanent installation.
Example:
# Permanent install
agr add kasperjunge/hello-world
# Temporary run (cleaned up after)
agrx kasperjunge/hello-world "your prompt"
Explanation: Use agrx to try skills before committing, or for one-off tasks.
See also: references/commands.md for command details.
How do I sync local resources?
Answer: Run agr sync to copy resources from authoring paths to .claude/.
Example:
# Set up authoring structure
agr init
# Create a skill
agr init skill my-skill
# Edit the skill
$EDITOR skills/my-skill/SKILL.md
# Sync to .claude/
agr sync
See also: references/workflows.md for the complete local authoring workflow.
Why do I get "Resource found in multiple types"?
Answer: The resource name exists as both a skill and command. Use --type to specify which one.
Example:
agr add kasperjunge/hello --type skill
agr add kasperjunge/hello --type command
See also: references/troubleshooting.md for other error solutions.
How do I create a shareable repository?
Answer: Use agr init repo to scaffold a repository others can install from.
Example:
# Create locally
agr init repo my-resources
# Or create and push to GitHub
agr init repo my-resources --github
Explanation: Name it agent-resources to let users install with agr add username/resource (shorter syntax).
See also: references/workflows.md for the complete repository setup workflow.