Skip to main content
Glama
dearsoft-skills
by dearsoft-bd

DearSoft Skills Engine ⚑

Python 3.10+ License: Apache 2.0 Zero Dependencies MCP Compatible

A high-speed, zero-dependency Universal AI Agent Skills Hub, REST API microservice, and Model Context Protocol (MCP) server.

Built by DearSoft (Dhaka, Bangladesh). Designed to manage, sync, and serve AI agent runbooks (SKILL.md) seamlessly across any AI platform (Claude Code, OpenAI/ChatGPT, Google Gemini, Codex Desktop, Cursor) and any web/SaaS application.


🌟 Why DearSoft Skills Engine?

  • Zero External Dependencies: Built 100% on Python standard library (http.server, urllib, json, dataclasses). Runs anywhere instantly without pip install issues.

  • Multi-Agent Sync: 1-click symlink or copy to Claude Code (~/.claude/skills), Codex (~/.codex/skills), and Antigravity/Cursor (~/.agents/skills).

  • Universal LLM Prompting: Formats any skill runbook into OpenAI, Google Gemini, or Anthropic system instruction payloads.

  • Secured REST API: Multithreaded HTTP microservice protected with profile-based login, API keys, and RBAC category filtering.

  • Native MCP Server: Exposes skills as tools directly to Cursor, Claude Desktop, Antigravity, and OpenClaw via standard JSON-RPC 2.0 over stdio.


Related MCP server: Agent Skill Runtime MCP Server

πŸš€ Quick Start

1. Installation

git clone https://github.com/dearsoft-bd/dearsoft-skills-engine.git
cd dearsoft-skills-engine
pip install -e .

2. CLI Usage

# List available skills
dearsoft-skills list

# Search skills
dearsoft-skills search "seo"

# Format skill prompt for Gemini API or OpenAI
dearsoft-skills get seo-audit --format gemini
dearsoft-skills get code-reviewer --format openai

# Sync skills to all local coding agents (Claude, Codex, Antigravity)
dearsoft-skills sync --target all

# Sync skills to a specific workspace
dearsoft-skills sync --dest ./my-app/.agents/skills

🌐 HTTP REST API Microservice

Run the microservice:

dearsoft-skills serve --port 8765

Endpoints

Method

Endpoint

Description

GET

/health

Service health check

POST

/api/auth/login

Login and receive a 7-day Bearer token

GET

/api/skills

List permitted skills for the authenticated profile

GET

/api/skills/{name}/prompt

Get ready-to-inject prompt formatted for target LLM

POST

/api/skills/inject

Inject skills directly into an existing chat request

POST

/api/skills/{name}/render

Render skill prompt with dynamic template variables

Example cURL Request

# 1. Login
curl -X POST "http://127.0.0.1:8765/api/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"username": "dearsoft-admin", "password": "YOUR_PASSWORD"}'

# 2. Get prompt with Bearer token
curl "http://127.0.0.1:8765/api/skills/seo-audit/prompt?target_llm=gemini" \
  -H "Authorization: Bearer <TOKEN>"

πŸ”Œ Model Context Protocol (MCP) Server

Add to your claude_desktop_config.json, cursor_mcp.json, or Antigravity mcp_config.json:

{
  "mcpServers": {
    "dearsoft-skills": {
      "command": "dearsoft-skills",
      "args": ["mcp"]
    }
  }
}

Exposed MCP Tools:

  • list_skills(category)

  • search_skills(query)

  • get_skill_prompt(skill_name, target_llm)


πŸ§ͺ Running Tests

python3 -m unittest discover -s tests

πŸ“„ License

Apache License 2.0. Developed by DearSoft.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Turns any folder of agent skills into a live MCP server, exposing skills_list, skills_get, and skills_search tools with zero-dependency stdio support.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Serves skill-defined JSON-in/JSON-out scripts as callable tools over MCP stdio, driven by a portable skill-runtime.json manifest that supplies each tool's title, description, and input schema. Exposes commands to validate, list, and run skills, so hosts can discover and invoke agent skills without custom per-skill glue code.
      16 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP hosts to list and render bundled prompt templates and fetch assistant blueprints for ChatGPT, Claude, Gemini, Grok, or portable Agent Skill format. Operates locally over stdio with read-only tools and no network, shell, account, or file-write access.
      3
      28 PyPI
      1
      MIT