Sandbox
@FrancyJGLisboa/agent-skills-platform

Tested agent skills with marketplace governance

Agent Skills Platform turns a workflow plus evidence into an installable skill package. It adds instructions, scripts, evals, security checks, and a representative run, then publishes that skill through a governed marketplace with versioning, discovery, rollback, and quarantine.

2,381 stars262 forksPythonUpdated 14d ago
Who it's for

Builders who want Claude Code, Codex, Cursor, or other agent tools to reuse approved workflows instead of redoing them from scratch.

What it delivers

You can turn a recurring workflow into a verified skill and share it through a controlled marketplace instead of distributing prompts by hand.

What it does

Skill creation from evidence

Builds a reusable skill from prompts, reports, spreadsheets, screenshots, transcripts, links, or scripts.

Verification and evals

Runs validation, security checks, evals, and a representative run before release.

Governed marketplace lifecycle

Supports admission, approval, release, distribution, updates, rollback, and quarantine for team skills.

Multi-platform distribution

Packages skills for installation across supported agent platforms and editors.

Maintenance evidence separation

Keeps raw evidence, draft patterns, and validated changes separate from the executable skill.

How to get it

  1. 1Agent Skills Platform turns the way people already work into tested, installable agent…
    /agent-skills-platform
    
    Turn my monthly revenue-variance review into a reusable internal skill.
    I attached past reports and the source spreadsheets. The decision is whether to
    escalate a material variance. It must not modify source data.
  2. 2Open the AI agent you already use, attach examples of the work, and paste this
    /agent-skills-platform
    
    Turn my monthly revenue-variance review into a reusable internal skill.
    I attached past reports and the source spreadsheets. The decision is whether to
    escalate a material variance. It must not modify source data.
  3. 3Govern team use. The marketplace provides ownership, approvals, versioned releases,…
    SME supplies examples and approves the result
            ↓
    Creator builds and verifies a skill
            ↓
    Marketplace operator governs and publishes it
            ↓
    Colleagues install an approved version and use it

README

Agent Skills Platform

Turn a real workflow into a tested, installable agent skill—then publish it safely to your team.

Agent Skills Platform: question to tested skill to governed marketplace

CI Agent Skills Open Standard Platforms Version License: MIT

Website · Installation · Worker runbook · Team marketplace · Product scope

Agent Skills Platform turns the way people already work into tested, installable agent skills. Give it a prompt plus the evidence behind the work—spreadsheets, reports, emails, screenshots, transcripts, links, or scripts—and it builds a reusable workflow that a person can inspect, an organization can review, and a team can safely reuse.

/agent-skills-platform

Turn my monthly revenue-variance review into a reusable internal skill.
I attached past reports and the source spreadsheets. The decision is whether to
escalate a material variance. It must not modify source data.

The result is not just a prompt: it is an installable skill package with instructions, functional scripts when needed, evals, security checks, a representative-run record, and a correction path for real-world learning.

After release, a skill can retain maintenance evidence without turning every log into runtime prompt context: classified run evidence is captured in raw/, recurring findings become evidence-linked draft patterns in wiki/, and only a separately validated change may update the executable skill. This is a governed maintenance record, not autonomous self-modification.

Create your first skill

Choose the path that matches what you need today.

First question: is this skill just for you, or will teammates install or reuse the skill itself?

  • Just for you — create, verify, and install it privately. No marketplace setup.
  • My team — create or select a governed GitHub/GitLab marketplace first, so the skill inherits real ownership and approval rules.

Teammates receiving a report or queue does not require a marketplace. Use the team path only when teammates will install or reuse the skill.

I have a workflow — no code required

Open the AI agent you already use, attach examples of the work, and paste this:

/agent-skills-platform

Turn my monthly revenue-variance review into a reusable internal skill.
I attached past reports and the source spreadsheets. The decision is whether to
escalate a material variance. It must not modify source data.

The creator asks for the business decisions only you can authorize, builds and tests the skill, and shows a representative result. When it is correct, say: “Publish this to the Finance marketplace.”

When the workflow uses an API, database, MCP, codebase, or structured file, Semantic Recon runs automatically before implementation and creates a pinned data contract. Use ./install.sh --without-semantic-recon only for a deliberately local, source-free installation.

Do not use Git, edit registry files, or run marketplace commands. If the creator is not installed in your agent, send this section to your marketplace operator.

I run the marketplace

Use the governed team marketplace guide to admit, approve, release, distribute, update, quarantine, and roll back tested skills.

I am evaluating the platform

Read the product scope, organizational acceptance protocol, and technical implementation guide.

Why teams use it

  • Preserve expert judgment. A skill captures the question, evidence, decision, and success measure behind recurring work.
  • Trust what is shared. Skills carry validation, security checks, evals, and a representative run before they are published.
  • Learn without runtime bloat. Maintenance keeps evidence, draft patterns, and rejected changes separate from the concise instructions an agent executes.
  • Govern team use. The marketplace provides ownership, approvals, versioned releases, discovery, rollback, quarantine, and compatibility evidence.

How work moves through the organization

SME supplies examples and approves the result
        ↓
Creator builds and verifies a skill
        ↓
Marketplace operator governs and publishes it
        ↓
Colleagues install an approved version and use it

The SME owns business meaning. The marketplace operator owns distribution and policy. See roles and handoffs.

See a verified result

The repository includes a live, read-only weather briefing example with a source-linked result and verification evidence. Start with the verification record, then inspect the skill package.

Read more when needed

NeedRead
Install on a supported AI toolInstallation
Create, correct, and hand off a first skillWorker runbook
Run a governed internal marketplaceTeam marketplace
Understand scope and product boundariesProduct scope
Review architecture, validation, and technical controlsTechnical overview
ContributeContributing

What happens behind the scenes

An Agent Skill is a reusable workflow package that guides an agent from a recognized situation to a verified outcome. It can use retrieved knowledge, MCP tools, APIs, deterministic scripts, and agent judgment, but it is not itself a RAG system, MCP server, or agent runtime.

RAG supplies knowledge. MCP supplies capabilities. The harness supplies execution. A skill organizes them into a governed path toward a verified outcome.

Reason where interpretation is necessary. Execute and verify with deterministic controls where reproducibility matters. External models, APIs, and changing data may vary rather than promising identical outputs.

Humans establish meaning. The factory does not expect you to know the correct prompt or semantic contract; it asks one bounded question at a time. The flow is:

  • Messy problem
  • Agent inspects evidence
  • Proposed / conflicting meanings
  • Human authority decision
  • Interview READY
  • Build, prove, publish

Every skill is checked as one connected system. The skill graph links its instructions, scripts, evaluations, and expected outputs. Two structural requirements confirm that every expected result is tested and every predictable multi-step workflow has one reliable entry point. Four checks—specification, pipeline, security, and evaluation schema—run in parallel. Finally, a representative run proves that the skill produces a useful result. The graph also enforces every_expected_is_reachable and deterministic_multistep_has_orchestrator.

See CONTRIBUTING.md and CODE_OF_CONDUCT.md. Contributions require the contributor assignment.

License

MIT. See LICENSE. Copyright © 2026 Francy J G Lisboa, also known as Charuto. See ownership.

Files in the repo

Repository payload34 top-level entries
  • .agents
  • .claude-plugin
  • .codex-plugin
  • .cursor-plugin
  • .github
  • .hallmark
  • assets
  • docs
  • exports
  • gates
  • references
  • registry
  • scripts
  • .gitignore
  • AGENTS.md
  • CHANGELOG.md
  • CITATION.cff
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • CONTRIBUTOR_ASSIGNMENT.md
  • COPYRIGHT.md
  • discovery.json
  • GATES.md
  • gemini-extension.json
  • install.ps1
  • install.sh
  • LAUNCH.md
  • LEARNINGS.md
  • LICENSE
  • PLAN.md
  • pytest.ini
  • README.md
  • ruff.toml
  • SKILL.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More harnesses

affaan-m/
ECC
affaan-m/ECCHarnesses

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

258k
ruvnet/rufloHarnesses

🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

72k

Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.

11k