claude-rust-tools 2.0.0

Tool implementations for bash and file operations
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

use claude_rust_errors::AppResult;
use claude_rust_types::{PermissionLevel, SearchReadInfo, Tool};
use serde_json::{Value, json};

/// Tool to invoke a skill by reading its SKILL.md file.
pub struct SkillTool;

impl SkillTool {
    pub fn new() -> Self {
        Self
    }
}

#[async_trait::async_trait]
impl Tool for SkillTool {
    fn name(&self) -> &str {
        "skill"
    }

    fn description(&self) -> &str {
        "Invoke a skill by name. Reads the skill definition from ~/.claude/skills/{name}/SKILL.md."
    }

    fn input_schema(&self) -> Value {
        json!({
            "type": "object",
            "properties": {
                "skill": {
                    "type": "string",
                    "description": "The skill name to invoke"
                },
                "args": {
                    "type": "string",
                    "description": "Optional arguments for the skill"
                }
            },
            "required": ["skill"]
        })
    }

    fn permission_level(&self) -> PermissionLevel {
        PermissionLevel::ReadOnly
    }

    fn is_read_only(&self, _input: &Value) -> bool { true }
    fn is_concurrent_safe(&self, _input: &Value) -> bool { true }

    fn is_search_or_read_command(&self, _input: &Value) -> SearchReadInfo {
        SearchReadInfo { is_search: false, is_read: true, is_list: false }
    }

    async fn execute(&self, input: Value) -> AppResult<String> {
        let skill = input
            .get("skill")
            .and_then(|v| v.as_str())
            .ok_or_else(|| claude_rust_errors::AppError::Tool("missing 'skill' field".into()))?;

        let args = input
            .get("args")
            .and_then(|v| v.as_str())
            .unwrap_or("");

        tracing::info!(skill, args, "invoking skill");

        let home = std::env::var("HOME")
            .map_err(|_| claude_rust_errors::AppError::Tool("HOME env var not set".into()))?;

        let skill_path = format!("{home}/.claude/skills/{skill}/SKILL.md");

        let content = tokio::fs::read_to_string(&skill_path)
            .await
            .map_err(|e| claude_rust_errors::AppError::Tool(
                format!("skill '{skill}' not found at {skill_path}: {e}")
            ))?;

        if args.is_empty() {
            Ok(content)
        } else {
            Ok(format!("{content}\n\n---\nArgs: {args}"))
        }
    }
}