registerskill

agent
Security Audit
Fail
Health Warn
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • exec() — Shell command execution in src/html-to-markdown.ts
  • network request — Outbound network request in src/index.ts
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool is a Cloudflare Worker that converts website URLs into AI-readable skill.md files and registers them in a searchable database. It provides a public API for creating, retrieving, and searching these generated skills.

Security Assessment
Overall risk: Medium. The repository failed a critical automated check for shell command execution (`exec()`) inside the HTML-to-markdown conversion file. It also makes outbound network requests, which is expected behavior for a tool that fetches and scrapes URLs, but this requires careful input sanitization to prevent Server-Side Request Forgery (SSRF). No hardcoded secrets or dangerous permissions were detected. However, the MIT license mentioned in the README is completely missing from the actual repository files.

Quality Assessment
The project was updated very recently, indicating active development. However, community trust and visibility are currently very low given it only has 5 stars. The discrepancy between the README stating "MIT" and the actual lack of a LICENSE file in the repository is a minor administrative red flag.

Verdict
Use with caution — the unpatched shell execution vulnerability and low community adoption warrant a thorough manual code review before deploying this in any production environment.
SUMMARY

A universal skill.md creator for any website. AI agents can register or take any action with human guidance.

README.md

RegisterSkill

A universal skill.md creator for any website. Make your website discoverable by AI agents.

Live Demo: registerskill.com

What It Does

  1. Converts any URL to an AI-readable skill.md file
  2. Registers websites in a searchable skill registry
  3. Generates badges webmasters can embed on their sites
  4. Supports multiple modes for different AI agent actions
  5. Tracks referrals with UTM parameters for analytics

Modes

Mode Description Frequency
blog_cron Monitor for new blog posts/content Daily
newsletter Help user subscribe to newsletter Once + 1 week reminder
signup_reminder Remind user to create account Once + 1 week reminder
summary_email Send website summary to email Once + 1 week reminder

Quick Start

Prerequisites

npm install -g wrangler

Install & Run Locally

# Install dependencies
npm install

# Create D1 database
wrangler d1 create ai-skill-registry
# Update database_id in wrangler.toml

# Initialize database
wrangler d1 execute ai-skill-registry --local --file=./schema.sql

# Start development server
npm run dev

Deploy to Cloudflare

# Initialize remote database
wrangler d1 execute ai-skill-registry --remote --file=./schema.sql

# Deploy
npm run deploy

API Reference

Register a Skill

POST /register
Content-Type: application/json

{
  "url": "https://example.com",
  "name": "example-site",
  "mode": "blog_cron"
}

Get Skill

# Get skill.md file (for AI agents)
GET /skill/{name}/skill.md

# Get metadata as JSON
GET /skill/{name}

Get Badge

GET /badge/{name}.svg

List & Search

# List all skills
GET /skills

# Search skills
GET /skills/search?q=documentation

For AI Agents

Read the skill.md to understand how to use this service:

https://registerskill.com/skill.md

Badge Integration

After registering, add a badge to your website:

HTML

<a href="https://registerskill.com/skill/your-site/skill.md" target="_blank">
  <img src="https://registerskill.com/badge/your-site.svg" alt="AI Agent Ready" />
</a>

Markdown

[![AI Agent Ready](https://registerskill.com/badge/your-site.svg)](https://registerskill.com/skill/your-site/skill.md)

Project Structure

registerskill/
├── src/
│   ├── index.ts              # Main worker (API + UI)
│   ├── html-to-markdown.ts   # HTML conversion
│   └── skill-formats.ts      # Format generators + badges
├── schema.sql                # D1 database schema
├── wrangler.toml             # Cloudflare config
├── package.json
└── README.md

Author

Metehan Yesilyurt

License

MIT

Reviews (0)

No results found