Clawhub Agent Artifact Scaffolder

Name: Clawhub Agent Artifact Scaffolder
Rating: 3.5 (1 reviews)
Author: agenticsrclab

By agenticsrclab 👁 48 views ▲ 0 votes

Generate safe starter repos for OpenClaw plugins, ClawHub skills, MCP servers, SDKs, and listing packs.

GitHub

Install

npm install -g

Configuration Example

{
  "ok": true,
  "template": "x402-service",
  "output": "/tmp/demo-public-intel-x402-service",
  "files": ["README.md", "agent-artifact.json"]
}

README

# ClawHub Agent Artifact Scaffolder

Generate safe starter repositories for public agent artifacts: OpenClaw
plugins, ClawHub skills, MCP servers, x402 services, marketplace listing packs,
and public SDKs.

## Value Proposition

Agent builders need a clean public repo before they can publish to marketplaces
or let other agents inspect their service. Starting from a blank folder often
leads to missing manifests, unsafe README examples, unclear payment boundaries,
or accidental secret exposure.

This scaffolder generates a conservative public repo shape with:

- README and `.gitignore`;
- `agent-artifact.json` metadata;
- package or manifest files where relevant;
- synthetic examples;
- self-validation tests;
- no-custody/no-signing/no-hidden-telemetry boundary copy.

## Who Should Use This

Use this tool when you want to create a new public artifact repo for:

- an OpenClaw plugin;
- a ClawHub skill;
- an MCP server;
- an x402-style service;
- a marketplace listing pack;
- a public SDK.

Do not use this tool to generate paid business logic, private source adapters,
wallet keys, or marketplace credentials.

## Current Status

Local release candidate implemented and E2E tested.

Public repo target:

```text
agenticsrclab/clawhub-agent-artifact-scaffolder
```

Package target:

```text
@agenticsrclab/clawhub-agent-artifact-scaffolder
```

The package has not been published from this local workspace yet. Use the local
source commands below until the public package exists.

## Install

From local source:

```bash
cd /Users/dtle/phoenix/non-profit-opensource/clawhub-agent-artifact-scaffolder
npm test
node ./bin/agent-artifact-scaffold.js list
```

After npm publication:

```bash
npm install -g @agenticsrclab/clawhub-agent-artifact-scaffolder
agent-artifact-scaffold list
```

## Quickstart

Generate an x402 service repo:

```bash
node ./bin/agent-artifact-scaffold.js create x402-service \
  --vertical demo \
  --sku-family public-intel \
  --owner agenticsrclab \
  --output /tmp/demo-public-intel-x402-service
```

Validate the generated repo:

```bash
npm --prefix /tmp/demo-public-intel-x402-service test

node ../openclaw-agent-marketplace-pack-doctor/bin/pack-doctor.js \
  check /tmp/demo-public-intel-x402-service --json

node ../openclaw-x402-boundary-inspector/bin/x402-boundary-inspector.js \
  inspect /tmp/demo-public-intel-x402-service/x402 --json
```

Expected result: the generated repo passes pack doctor and x402 boundary
inspection with `ok: true`.

## Templates

| Template | Generated Repo Shape |
|---|---|
| `openclaw-plugin` | `package.json`, `openclaw.plugin.json`, `src/index.js`, self-validation test. |
| `clawhub-skill` | `package.json`, `SKILL.md`, `src/index.js`, self-validation test. |
| `mcp-server` | `package.json`, `mcp.json`, `src/server.js`, self-validation test. |
| `x402-service` | `package.json`, `src/server.js`, synthetic x402 manifest/listing/sample/challenge fixtures, self-validation test. |
| `marketplace-listing-pack` | `package.json`, listing metadata, synthetic x402 fixtures, self-validation test. |
| `public-sdk` | `package.json`, `src/index.js`, no-spend plan helper, self-validation test. |

## Command Reference

```bash
agent-artifact-scaffold list
agent-artifact-scaffold create <template> \
  --vertical <vertical-slug> \
  --sku-family <sku-family-slug> \
  --owner <github-owner> \
  [--package-scope <npm-scope>] \
  [--output <directory>] \
  [--force]
```

The `create` command prints JSON:

```json
{
  "ok": true,
  "template": "x402-service",
  "output": "/tmp/demo-public-intel-x402-service",
  "files": ["README.md", "agent-artifact.json"]
}
```

## Safety Boundary

Generated repos are intentionally public-safe:

- no wallet custody;
- no automatic payment signing;
- no hidden telemetry;
- no private source data;
- no TradeOS credentials required;
- paid execution must require explicit caller authorization.

## Development

```bash
npm test
node ./bin/agent-artifact-scaffold.js list
```

tools