Back to search
dearsoft-skills-engine
MCP serverGitHub
Zero-dependency universal AI agent skills hub, CLI, REST API microservice, and MCP server for Claude, Codex, Gemini & Antigravity.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/dearsoft-bd--dearsoft-skills-engine)HTML
<a href="/listings/dearsoft-bd--dearsoft-skills-engine"><img src="/api/listings/dearsoft-bd--dearsoft-skills-engine/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 122 lines
- # DearSoft Skills Engine ⚡
- [](https://www.python.org/)
- [](https://opensource.org/licenses/Apache-2.0)
- [-brightgreen.svg)]()
- [](https://modelcontextprotocol.io/)
- > **A high-speed, zero-dependency Universal AI Agent Skills Hub, REST API microservice, and Model Context Protocol (MCP) server.**
- Built by [DearSoft](https://dearsoft.com.bd) (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.
- ---
- ## 🚀 Quick Start
- ### 1. Installation
- ```bash
- git clone https://github.com/dearsoft-bd/dearsoft-skills-engine.git
- cd dearsoft-skills-engine
- pip install -e .
- ```
- ### 2. CLI Usage
- ```bash
- # 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:
- ```bash
- 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
- ```bash
- # 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`:
- ```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
- ```bash
- python3 -m unittest discover -s tests
- ```
- ---
- ## 📄 License
- Apache License 2.0. Developed by [DearSoft](https://dearsoft.com.bd).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.