← Back to Skills Marketplace
mirni

Skillforge

by mirni · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
103
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install gh-skillforge
Description
Generate valid, ClawHub-ready SKILL.md files from product metadata. Give it a name, description, and instructions — get back a properly formatted SKILL.md wi...
README (SKILL.md)

SkillForge

Generate a SKILL.md ready to publish on ClawHub.

Start the server

uvicorn skillforge.app:app --port 8003

Generate a SKILL.md

curl -s -X POST http://localhost:8003/v1/forge-skill \
  -H "Content-Type: application/json" \
  -d '{"name": "My Cool Tool", "description": "Does cool things.", "instructions": "Step 1: Be cool."}' | jq

Returns skill_md (the complete SKILL.md content) and slug (ClawHub-compatible name like my-cool-tool).

With optional env vars and bins

curl -s -X POST http://localhost:8003/v1/forge-skill \
  -H "Content-Type: application/json" \
  -d '{"name": "API Client", "description": "Calls APIs.", "instructions": "Use curl.", "env_vars": ["API_KEY"], "bins": ["curl"]}' | jq '.skill_md' -r

Slug rules

Names are auto-converted to ClawHub slugs: lowercase, spaces to dashes, special chars removed. "My Tool v2!" becomes my-tool-v2.

Usage Guidance
This skill appears to be a simple local service for producing SKILL.md files and is coherent with its dependencies. Before installing: (1) be aware it will install common PyPI packages (fastapi, uvicorn, pydantic, pyyaml); verify you trust those packages and your environment's pip configuration. (2) The server runs locally via uvicorn — do not bind it to public interfaces or expose it to untrusted networks. (3) The generator will include any user-supplied text verbatim in the generated SKILL.md (including any env var names or command names you pass) — do not feed it secrets or untrusted input if you plan to auto-publish outputs without manual review.
Capability Analysis
Type: OpenClaw Skill Name: gh-skillforge Version: 1.0.0 The gh-skillforge skill is a utility designed to generate properly formatted SKILL.md files for the OpenClaw ecosystem. It implements a simple FastAPI server (skillforge/app.py) that takes metadata as input and uses standard libraries like PyYAML and Pydantic to produce valid Markdown output. There are no signs of malicious intent, data exfiltration, or risky execution patterns.
Capability Assessment
Purpose & Capability
Name/description match the code and runtime instructions. The package is a small FastAPI service that accepts metadata and returns SKILL.md; requiring Python and common Python packages (fastapi, uvicorn, pydantic, pyyaml) is consistent with this purpose.
Instruction Scope
The provided SKILL.md instructs running a local uvicorn server and posting JSON to /v1/forge-skill. The code only processes the provided fields into YAML frontmatter + markdown; it does not read unrelated files, environment variables, or remote endpoints.
Install Mechanism
Installation uses pip packages (fastapi, uvicorn, pydantic, pyyaml) which is expected. The install spec's 'kind' value 'uv' is unusual but does not indicate a download-from-arbitrary-URL pattern; overall install risk is moderate (standard public PyPI packages).
Credentials
No environment variables or credentials are requested by the skill. The generator accepts an env_vars list to include in generated SKILL.md (this is output metadata, not requested secrets).
Persistence & Privilege
The skill is not always-enabled and does not request elevated platform privileges or modify other skills. Autonomous invocation is allowed by default but is not combined with other concerning factors.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gh-skillforge
  3. After installation, invoke the skill by name or use /gh-skillforge
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Major documentation update with improved clarity and examples. - Expanded usage instructions, including examples with optional parameters (env vars and bins). - Added a section detailing slug normalization rules. - Updated metadata frontmatter with additional details and emoji. - Removed redundant version and metadata fields for a cleaner SKILL.md.
v0.1.1
- Renamed skill to gh-skillforge - Updated version to 0.1.1 - Added OpenClaw metadata (required bins and install instructions) - Improved documentation: now includes installation steps and updated usage instructions - Example usage now targets localhost instead of hosted API - Added pydantic to install requirements
v0.1.0
Initial release of SkillForge. - Generate ClawHub-compatible SKILL.md files from product metadata. - Supports hosted API and standalone local server. - Handles slug normalization, versioning, and optional metadata (env_vars, bins). - Returns valid YAML frontmatter and Markdown body in responses.
Metadata
Slug gh-skillforge
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Skillforge?

Generate valid, ClawHub-ready SKILL.md files from product metadata. Give it a name, description, and instructions — get back a properly formatted SKILL.md wi... It is an AI Agent Skill for Claude Code / OpenClaw, with 103 downloads so far.

How do I install Skillforge?

Run "/install gh-skillforge" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Skillforge free?

Yes, Skillforge is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Skillforge support?

Skillforge is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Skillforge?

It is built and maintained by mirni (@mirni); the current version is v1.0.0.

💬 Comments