Skip to content
Back to search

dearsoft-skills-engine

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dearsoft-bd--dearsoft-skills-engine/badge.svg)](/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
  1. # DearSoft Skills Engine ⚡
  2. [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)
  3. [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-green.svg)](https://opensource.org/licenses/Apache-2.0)
  4. [![Zero Dependencies](https://img.shields.io/badge/dependencies-0%20(stdlib%20only)-brightgreen.svg)]()
  5. [![MCP Compatible](https://img.shields.io/badge/MCP-JSON--RPC%202.0-purple.svg)](https://modelcontextprotocol.io/)
  6. > **A high-speed, zero-dependency Universal AI Agent Skills Hub, REST API microservice, and Model Context Protocol (MCP) server.**
  7. 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**.
  8. ---
  9. ## 🌟 Why DearSoft Skills Engine?
  10. * **Zero External Dependencies**: Built 100% on Python standard library (`http.server`, `urllib`, `json`, `dataclasses`). Runs anywhere instantly without `pip install` issues.
  11. * **Multi-Agent Sync**: 1-click symlink or copy to Claude Code (`~/.claude/skills`), Codex (`~/.codex/skills`), and Antigravity/Cursor (`~/.agents/skills`).
  12. * **Universal LLM Prompting**: Formats any skill runbook into OpenAI, Google Gemini, or Anthropic system instruction payloads.
  13. * **Secured REST API**: Multithreaded HTTP microservice protected with profile-based login, API keys, and RBAC category filtering.
  14. * **Native MCP Server**: Exposes skills as tools directly to Cursor, Claude Desktop, Antigravity, and OpenClaw via standard JSON-RPC 2.0 over stdio.
  15. ---
  16. ## 🚀 Quick Start
  17. ### 1. Installation
  18. ```bash
  19. git clone https://github.com/dearsoft-bd/dearsoft-skills-engine.git
  20. cd dearsoft-skills-engine
  21. pip install -e .
  22. ```
  23. ### 2. CLI Usage
  24. ```bash
  25. # List available skills
  26. dearsoft-skills list
  27. # Search skills
  28. dearsoft-skills search "seo"
  29. # Format skill prompt for Gemini API or OpenAI
  30. dearsoft-skills get seo-audit --format gemini
  31. dearsoft-skills get code-reviewer --format openai
  32. # Sync skills to all local coding agents (Claude, Codex, Antigravity)
  33. dearsoft-skills sync --target all
  34. # Sync skills to a specific workspace
  35. dearsoft-skills sync --dest ./my-app/.agents/skills
  36. ```
  37. ---
  38. ## 🌐 HTTP REST API Microservice
  39. Run the microservice:
  40. ```bash
  41. dearsoft-skills serve --port 8765
  42. ```
  43. ### Endpoints
  44. | Method | Endpoint | Description |
  45. | :--- | :--- | :--- |
  46. | `GET` | `/health` | Service health check |
  47. | `POST` | `/api/auth/login` | Login and receive a 7-day Bearer token |
  48. | `GET` | `/api/skills` | List permitted skills for the authenticated profile |
  49. | `GET` | `/api/skills/{name}/prompt` | Get ready-to-inject prompt formatted for target LLM |
  50. | `POST` | `/api/skills/inject` | Inject skills directly into an existing chat request |
  51. | `POST` | `/api/skills/{name}/render` | Render skill prompt with dynamic template variables |
  52. ### Example cURL Request
  53. ```bash
  54. # 1. Login
  55. curl -X POST "http://127.0.0.1:8765/api/auth/login" \
  56. -H "Content-Type: application/json" \
  57. -d '{"username": "dearsoft-admin", "password": "YOUR_PASSWORD"}'
  58. # 2. Get prompt with Bearer token
  59. curl "http://127.0.0.1:8765/api/skills/seo-audit/prompt?target_llm=gemini" \
  60. -H "Authorization: Bearer <TOKEN>"
  61. ```
  62. ---
  63. ## 🔌 Model Context Protocol (MCP) Server
  64. Add to your `claude_desktop_config.json`, `cursor_mcp.json`, or Antigravity `mcp_config.json`:
  65. ```json
  66. {
  67. "mcpServers": {
  68. "dearsoft-skills": {
  69. "command": "dearsoft-skills",
  70. "args": ["mcp"]
  71. }
  72. }
  73. }
  74. ```
  75. Exposed MCP Tools:
  76. - `list_skills(category)`
  77. - `search_skills(query)`
  78. - `get_skill_prompt(skill_name, target_llm)`
  79. ---
  80. ## 🧪 Running Tests
  81. ```bash
  82. python3 -m unittest discover -s tests
  83. ```
  84. ---
  85. ## 📄 License
  86. Apache License 2.0. Developed by [DearSoft](https://dearsoft.com.bd).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.