clawskills-strands

KO | EN

gitlite — search

#javascript #python #hacktoberfest #llm #go #android #deep-learning #linux #cli #kubernetes #pytorch #security #mcp #openai

clawskills-strands

(★ 9)

Convert OpenClaw skills (markdown documentation) to executable Strands Agents tools

clawskills-strands Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# clawskills-strands

Convert OpenClaw skills (markdown documentation) to executable Strands Agents tools.

## Overview

OpenClaw skills are markdown files that document CLI commands and workflows. In OpenClaw, agents read these files and execute commands manually. This package converts those skills into **directly executable Strands Agents tools**, making them immediately usable without the read-then-exec pattern.

## Installation

```bash
npm install clawskills-strands
```

**Peer Dependencies:**
- `@strands-agents/sdk` - Required for tool creation
- `zod` - Required for schema validation

## Quick Start

```typescript
import { Agent } from '@strands-agents/sdk'
import { BedrockModel } from '@strands-agents/sdk'
import { loadSkills, convertSkillsToTools } from 'clawskills-strands'

// Load all 52 bundled OpenClaw skills (included with package)
const skills = await loadSkills({
  useBundled: true
})

// Convert to Strands tools
const tools = await convertSkillsToTools(skills)

// Use with Strands Agent
const agent = new Agent({
  model: new BedrockModel({ region: 'us-east-1' }),
  tools: tools
})

// Agent can now use skills directly as tools!
await agent.invoke('Get the weather for London')
```

## Features

- ✅ **52 Bundled Skills**: All OpenClaw skills included and ready to use
- ✅ **Skill Loader**: Load skills from bundled package or external directories
- ✅ **Skill Parser**: Parse SKILL.md files with frontmatter and JSON5 metadata
- ✅ **Tool Converter**: Automatically convert skills to executable Strands tools
- ✅ **Type-Safe**: Full TypeScript support with proper types
- ✅ **Standalone**: No OpenClaw dependency required
- ✅ **Extensible**: Easy to add custom skill directories

## API Reference

### `loadSkills(options?)`

Load skills from various sources.

```typescript
const skills = await loadSkills({
  useBundled: true,        // Include bundled skills (default: true)
  skillsDir: './my-skills', // Primary directory to load from
  extraDirs: [             // Additional directories
    './custom-skills',
    process.env.OPENCLAW_SKILLS_DIR
  ]
})
```

**Returns:** `Promise<Skill[]>` - Array of loaded skills

### `loadBundledSkills()`

Load only the skills bundled with the package.

```typescript
const bundledSkills = await loadBundledSkills()
```

### `loadSkillByName(name, options?)`

Load a specific skill by name.

```typescript
const weatherSkill = await loadSkillByName('weather', {
  useBundled: true
})
```

### `convertSkillToTool(skill, options?)`

Convert a single skill to a Strands tool.

```typescript
const tool = await convertSkillToTool(skill, {
  useBash: true,  // Use bash for command execution (default: true)
  executor: customExecutor  // Optional custom executor function
})
```

**Returns:** `Promise<Tool>` - A Strands-compatible tool

### `convertSkillsToTools(skills, options?)`

Convert multiple skills to Strands tools.

```typescript
const tools = await convertSkillsToTools(skills)
```

## How It Works

### Skill Format

Skills are markdown files with YAML frontmatter:

```markdown
---
name: weather
description: Get current weather and forecasts
metadata: { "openclaw": { "emoji": "🌤️", "requires": { "bins": ["curl"] } } }
---

# Weather

```bash
curl -s "wttr.in/London?format=3"
```
```

### Conversion Process

1. **Parse**: Extract frontmatter and content from SKILL.md
2. **Analyze**: Extract CLI command patterns from code blocks
3. **Infer Schema**: Automatically infer Zod input schema from commands
4. **Create Tool**: Generate Strands tool with executable callback

### Example Output

```json
{
  "skillsLoaded": 3,
  "toolsCreated": 3,
  "tools": [
    {
      "name": "weather",
      "description": "Get current weather and forecasts (no API key required).",
      "hasSchema": true
    }
  ]
}
```

## Examples

### Basic Usage

```typescript
import { loadSkills, convertSkillsToTools } from 'clawskills-strands'
import { Agent, BedrockModel } from '@strands-agents/sdk'

const skills = await loadSkills({ useBundled: true })
const tools = await convertSkillsToTools(skills)

const agent = new Agent({
  model: new BedrockModel({ region: 'us-east-1' }),
  tools: tools
})
```

### Custom Skills Directory

```typescript
const skills = await loadSkills({
  useBundled: true,
  skillsDir: './my-custom-skills',
  extraDirs: ['./workspace-skills']
})
```

### Single Skill

```typescript
import { loadSkillByName, convertSkillToTool } from 'clawskills-strands'

const skill = await loadSkillByName('github')
const githubTool = await convertSkillToTool(skill)
```

See `examples/` directory for complete examples with outputs.

## Skill Conversion Details

### Supported Skill Patterns

The converter intelligently handles different skill types:

- **CLI Tools** (e.g., `gh`, `memo`, `curl`): Extracts command patterns
- **API Tools** (e.g., Notion, GitHub API): Infers parameters from examples
- **Simple Commands**: Creates generic command parameter
- **Complex Workflows**: Extracts multiple command patterns

### Schema Inference

The converter analyzes skill content to infer input schemas:

- **GitHub skills**: Infers `repo`, `prNumber`, `issueNumber`, `limit`
- **Weather skills**: Infers `location`, `format`
- **Notes skills**: Infers `action`, `title`, `query`, `folder`
- **Generic**: Falls back to `command` + `args` parameters

### Command Building

Commands are built from:
1. Skill-specific patterns (e.g., GitHub, Weather)
2. Extracted command templates from markdown
3. Parameter substitution from user input

## Project Structure

```
clawskills-strands/
├── src/
│   ├── types.ts          # Type definitions
│   ├── parser.ts          # Skill file parser
│   ├── loader.ts          # Skill loader
│   ├── converter.ts       # Skill to tool converter
│   └── index.ts           # Main exports
├── skills/                # Bundled skills (copied from OpenClaw)
├── examples/              # Usage examples
│   ├── src/               # Example source files
│   └── outputs/           # Example run outputs
├── dist/                  # Compiled output
└── package.json
```

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Test
npm test

# Run examples
npx tsx examples/run-example.ts
```

## Publishing

```bash
# Build and test
npm run prepublishOnly

# Publish
npm publish
```

## License

MIT

## Contributing

Contributions welcome! This package converts OpenClaw skills to Strands tools, making them directly usable in Strands Agents.

clawskills-strands

clawskills-strands Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

clawskills-strands

clawskills-strands Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README