Port Skills Registry Demo

A curated collection of Cursor Agent Skills organized for demonstration of Port’s skills registry capabilities.

This repository demonstrates how to build and manage a skills registry using Port’s service catalog, with 65+ real, production-ready skills organized by category.

Quick Start

# Install a skill to your personal skills directory
cp -r skills/workflow/incident-response ~/.cursor/skills/

# Or install to a project
cp -r skills/testing/writing-tests .cursor/skills/

Skills by Category

🎯 Port-Specific Skills

Skills that integrate with Port’s service catalog and MCP:

🔧 Cursor-Native Skills (27 skills)

Skills that leverage Cursor’s unique agent capabilities:

📊 Analytics & Tracking (3 skills)

🧪 Testing (6 skills)

🏗️ Infrastructure (4 skills)

🔍 Code Quality (6 skills)

🎨 Frontend & UI (5 skills)

🔄 Workflow (5 skills)

📐 Planning & Architecture (2 skills)

📚 Documentation (2 skills)

🛠️ Utilities (5 skills)

Skill Structure

Each skill is a folder containing a SKILL.md file:

skills/
├── port-specific/
│   ├── triage-incident/
│   │   └── SKILL.md
│   └── ...
├── cursor-native/
│   ├── codebase-onboarding/
│   │   └── SKILL.md
│   └── ...
└── ...

SKILL.md Format

---
name: skill-name
description: What this skill does. When to use it.
user-invocable: true
---

# Skill Name

## When to Use
- Trigger scenario 1
- Trigger scenario 2

## Process
1. Step 1
2. Step 2

## Quality Checklist
- [ ] Verification item

Port Integration

This registry is designed to work with Port’s service catalog:

1. Ingest skills as entities - Each SKILL.md becomes a Port entity
2. Track ownership - Skills are owned by teams
3. Scorecard compliance - Ensure skills meet quality standards
4. Self-service installation - Install skills via Port actions

Blueprint Example

identifier: skill
title: Skill
schema:
  properties:
    name:
      type: string
    description:
      type: string
    category:
      type: string
      enum: [port-specific, cursor-native, testing, infrastructure, ...]
    invocable:
      type: boolean
  required:
    - name
    - description

Contributing

1. Add your skill to the appropriate category folder
2. Follow the SKILL.md format with frontmatter
3. Keep skills under 500 lines
4. Include quality checklist

Credits

Base skills sourced from awesome-cursor-skills by Spencer Pauly.

License

MIT