Feature: Skills and Prompts - EyevinnOSC/community GitHub Wiki

Skills and Prompts

The Skills & Prompts feature in the OSC Builders section lets you publish reusable AI skills, prompts, and runbooks to the platform. Once published, they can be shared with other teams or discovered via the OSC MCP server.

What You Can Contribute

  • Skill — a Claude Code slash command (.md file) that an AI agent can invoke
  • Prompt — a reusable natural language instruction or system prompt
  • Runbook — a step-by-step operational guide intended for AI-assisted execution

Each contribution is stored as a public Gitea repository under your workspace's namespace, with full revision history tracked in Gitea.

Prerequisites

  • An OSC account (any plan)
  • A Builders workspace (available to all contributors listed in the Creator section)

Contributing a Skill or Prompt

Via Web Console

  1. Navigate to Builders in the OSC web console
  2. Click the Skills & Prompts tab
  3. Click Contribute
  4. Fill in the form:
    • Display Name — a human-readable name shown on skill cards and the public skill page (e.g. "Captain Liivo")
    • Slug — auto-generated from the Display Name; lowercase alphanumeric and hyphens, unique per workspace. You can override it by editing the Slug field directly. Cannot be changed after creation.
    • Type — Skill, Prompt, or Runbook
    • Description — a short description of what it does
    • License — MIT, Apache 2.0, or CC-BY 4.0
    • Content — the Markdown or YAML content of your skill or prompt
    • Screenshot (optional) — upload an image file to use as a preview thumbnail; displayed as a 16:9 image on community skill cards and on the public skill page below the share buttons
  5. Click Contribute to publish

After submission, a share URL is shown that links to the public skill page on OSC (https://app.osaas.io/skills/{tenantId}/{skillName}). Copy it or use the LinkedIn, X, or Bluesky share buttons to share it on social media.

Each skill card also displays a Clone URL — the anonymous HTTPS git clone URL for the Gitea repository backing the skill. Click the copy button next to it to copy the URL to your clipboard, then use it with any standard git client:

git clone https://auto.prod.osaas.io/oscadmin/skills-{tenantId}-{skillName}.git

Editing a Skill

Each skill card in the Builders dashboard has a pencil icon. Clicking it opens the Edit Skill modal, pre-populated with the skill's current description, type, screenshot, and content. You can update the description, type, screenshot, and content. Click Save to update the skill in place. The Display Name and slug cannot be changed after creation — the slug is part of the share URL and the backing Gitea repository slug. The license cannot be changed after publishing; contact support if you need to relicense.

Deleting a Skill

Each skill card has a trash icon. Clicking it opens a Delete Skill confirmation modal. Confirming the deletion permanently removes the skill and its backing Gitea repository. This action cannot be undone.

Public Skill Page

Every published skill has a public page at:

https://app.osaas.io/skills/{tenantId}/{skillName}

This page is accessible without login and renders the skill's name, description, type, and license. It includes Open Graph meta tags so link previews work on LinkedIn, X (Twitter), Bluesky, and other social platforms. The page is explicitly allowed for search engine indexing, so public skills can be discovered via Google, Bing, and other search engines.

If the skill has a screenshot set, it is displayed as a full-width 16:9 image below the share buttons, giving visitors a visual preview of the skill or the tool it automates.

The page includes share buttons so visitors can spread the skill to their networks:

  • Copy link — copies the canonical URL to the clipboard
  • LinkedIn — opens the LinkedIn share dialog with the skill URL pre-filled
  • X (Twitter) — opens a pre-composed tweet linking to the skill
  • Bluesky — opens a Bluesky compose window with the skill URL included

Share buttons are also shown in the skill card on the Builders dashboard and in the post-contribute confirmation modal.

If the skill has a public git repository, the page also shows a Clone repository section with the anonymous HTTPS clone URL and a copy button. Visitors can clone the repository directly without authentication:

git clone <clone-url-shown-on-page>

If the skill has prompt content, the page shows the content under a Prompt heading with a copy button. Click it to copy the full prompt text to the clipboard — useful when loading the skill into Claude, Cursor, or any other AI assistant that accepts paste-in system prompts.

The page also shows a link to Connect your AI assistant to OSC via MCP, which points to the OSC MCP integration guide. Visitors can click it to wire up Claude Code, Cursor, or other MCP-compatible tools and start using OSC skills directly from their AI assistant.

Authenticated users who visit a public skill URL are redirected to /dashboard/builders where they can edit and manage their own skills.

Via MCP (AI Agent)

You can list skills published in your workspace:

list-published-skills

And fetch the content of a specific skill:

get-published-skill
  name: "my-skill"

The shareUrl in the response links to the public skill page at https://app.osaas.io/skills/{tenantId}/{skillName}. The cloneUrl can be used to clone the Gitea repository locally.

To execute a skill, pipe the returned content into create-agent-task with the skill content as the prompt field. The AI agent reads the skill and acts on it directly without a separate run step.

To update a skill you own (without deleting and recreating it):

update-published-skill
  name: "my-skill"
  content: "# Updated skill\n\nNew instructions here."
  description: "Updated description"
  type: "runbook"
  tags: ["automation", "deploy"]
  screenshotUrl: "https://example.com/screenshot.png"
  displayName: "My Skill"
  message: "Fix step 3 wording"

All fields except name are optional — only the fields you provide are changed. The screenshotUrl field accepts a public image URL and is displayed as a preview thumbnail on the skill card. Pass an empty string to clear an existing screenshot. The displayName field sets the human-readable name shown on skill cards; if omitted, the slug is displayed instead. The message field is an optional commit message. The shareUrl is returned in the response.

To permanently delete a skill from your workspace:

delete-published-skill
  name: "my-skill"

This removes the Gitea repository backing the skill. The action cannot be undone.

You can browse and import community skills published by other OSC tenants:

list-community-skills
  query: "transcoding"      # optional keyword search
  type: "skill"             # optional: skill, prompt, or runbook
  tags: ["video", "ffmpeg"] # optional tag filters
  limit: 20                 # optional, default 50

Each result includes the tenantId, name, displayName, type, description, license, tags, screenshotUrl, and a shareUrl linking to the public skill page. The displayName is the human-readable name for the skill; fall back to name if absent.

To copy a community skill into your own workspace:

import-community-skill
  tenantId: "other-tenant"
  name: "community-skill-a"
  newName: "my-copy"  # optional — defaults to the original name

The import creates a new skill in your workspace with the same content, type, license, and description. The forkedFrom field in the resulting skill records the origin.

Community Skills Index

The public community skills index is available at https://app.osaas.io/skills — no login required. It lists all published skills across all OSC tenants. Skill cards display the screenshot as a 16:9 image at the top of the card when one is set, giving visitors an immediate visual preview of the skill. The index supports:

  • Keyword search — filter by name or description
  • Type filter — show only Skills, Prompts, or Runbooks
  • Pagination — browse large result sets page by page

From the Builders dashboard, the Browse community skills button links directly to this index.

An Atom 1.0 feed of the 20 most recently published skills is available at:

https://app.osaas.io/skills/feed.xml

This feed is compatible with all standard RSS readers and aggregators. Each entry includes the skill name, description, author, type, tags, and a link to the public skill page.

Published skills appear in the community index immediately after creation or update. Deleting a skill removes it from the index in real time.

Licensing

Choose the license that matches how you want others to use your contribution:

License Summary
MIT Permissive — anyone can use, modify, and redistribute
Apache 2.0 Permissive with patent grant
CC-BY 4.0 Requires attribution — suitable for documentation and prompts

Public Skill Preview API

A public API endpoint is available for fetching skill metadata and content without authentication:

GET https://ai.svc.prod.osaas.io/skills/{tenantId}/{skillName}

Returns a JSON object with name, type, description, license, content, createdAt, tags, tenantId, cloneUrl, and screenshotUrl fields. The cloneUrl field contains the anonymous HTTPS git clone URL when available. The screenshotUrl field is present when the contributor has set a preview image. Responses include Cache-Control: public, max-age=300. No authentication is required — this is the same data shown on the public skill page.

Versioning

The Gitea repository for each contribution tracks full revision history via git commits. Each save through the console or MCP creates a new commit. Clone the repository using the clone URL shown on the skill card to inspect the full history locally with standard git tooling.

Related Resources