Model or dataset
FrancyJGLisboa/agent-skills-platform avatar
FrancyJGLisboa/agent-skills-platform

Agent Skills Platform: turning a workflow into a governed, installable skill

Build tested agent skills and govern their lifecycle through a user-defined marketplace: evidence, discovery, updates, rollback, quarantine, and 17-platform distribution.

2,384 stars262 forksPythonMIT

At a glance

What is it?
Agent Skills Platform is a Python toolchain and marketplace for building tested agent skills from real evidence, then distributing them across 17 platforms. Its value is the governance layer around skill creation and release, not the prompt itself.
Who is it for?
Adopt it if you have a recurring decision workflow with real evidence behind it and a team that needs to install the same approved version, with an operator who will run the marketplace. Do not adopt it if you want a single prompt file, or if nobody will own approvals and quarantine.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

The problem: a workflow trapped in one person's head

Most teams already have the workflow. What they lack is a way to hand it to an agent without losing the judgment that made it work. A prompt captures the instruction but not the evidence, the decision boundary, or the check that tells you the output was right. Agent Skills Platform targets that gap. It takes a described workflow plus the material behind it (spreadsheets, reports, emails, screenshots, transcripts, links, scripts) and produces what the README calls an installable skill package: instructions, functional scripts when needed, evals, security checks, a representative-run record, and a correction path. The audience is split in two. On one side is a subject matter expert who can describe the decision and approve the result but should not touch Git or registry files. On the other is a marketplace operator who admits, approves, releases, distributes, updates, quarantines, and rolls back skills. The README is explicit that a teammate receiving a report or a queue does not need a marketplace; the governed path is only for when teammates install or reuse the skill itself. That distinction matters, because it is the difference between a personal prompt library and an organizational artifact.

Evidence in, package out: what the creator actually assembles

The mechanism is a build step driven by a slash command. The user opens their existing AI agent, attaches examples, and invokes /agent-skills-platform with a plain-language description of the workflow and its constraints. The README's own example asks for a monthly revenue-variance review to become a reusable internal skill, states that the decision is whether to escalate a material variance, and states that it must not modify source data. That last clause is the interesting part. Constraints like it are treated as part of the specification rather than as prompt decoration, and the creator is described as asking for the business decisions only the user can authorize, one bounded question at a time. The output is not a prompt. It is a package with instructions, optional deterministic scripts, evals, security checks, and a recorded representative run. The platform also draws a boundary around itself: an Agent Skill is not a RAG system, an MCP server, or an agent runtime. RAG supplies knowledge, MCP supplies capabilities, the harness supplies execution, and the skill organizes them into a path toward a verified outcome. Where interpretation is needed the agent reasons; where reproducibility matters the package uses deterministic controls. The README concedes that external models, APIs, and changing data may vary, so identical outputs are not promised.

Semantic Recon and the pinned data contract

One component is called out by name. When a workflow touches an API, a database, an MCP server, a codebase, or a structured file, Semantic Recon runs automatically before implementation and creates a pinned data contract. The README does not describe the contract's format or how drift is detected, so the enforcement details are not verifiable from the material provided. What is verifiable is the escape hatch: ./install.sh --without-semantic-recon exists, and the README restricts it to a deliberately local, source-free installation. That phrasing implies Semantic Recon reaches out to inspect sources, which is a data-handling decision a team should make before installing rather than after. If your sources are regulated or air-gapped, the flag is the documented path, and the cost is that you give up the pinned contract. If your sources are reachable and you want the contract, the default install is the one to use. Either way, the choice is made at install time.

Getting it running: the install and the two entry paths

The documented install command is ./install.sh, with the single documented flag being --without-semantic-recon. The README states the platform installs on 17 platforms and links to docs/INSTALL.md for the supported list; it does not enumerate them in the text provided, so check that document against your agent before committing. The README also says that if the creator is not installed in your agent, you should send the relevant section to your marketplace operator, which implies the slash command is not universally available out of the box. Beyond installation there are two documented paths. The no-code path is the one shown above: attach examples, paste the command, answer the creator's questions, then say Publish this to the Finance marketplace. The operator path uses docs/TEAM_MARKETPLACE.md to admit, approve, release, distribute, update, quarantine, and roll back skills. The README instructs the non-technical user not to use Git, edit registry files, or run marketplace commands. If you are the operator, the worker runbook (docs/WORKER_RUNBOOK.md) covers creating, correcting, and handing off a first skill.

The maintenance record is not self-modifying, and that is deliberate

Post-release behavior is the part most likely to be misread. Classified run evidence is captured in raw/. Recurring findings become evidence-linked draft patterns in wiki/. Only a separately validated change may update the executable skill. The README states plainly that this is a governed maintenance record, not autonomous self-modification. That separation is the design's main discipline: the agent executes concise instructions, while evidence, drafts, and rejected changes stay outside the runtime prompt context. The trade-off is latency and human load. A finding that recurs has to be reviewed and validated by someone before it changes anything, so the loop does not close itself. Teams that want the skill to improve on its own will find this too slow; teams that have been burned by silent drift will read it as the point. The README frames the benefit as learning without runtime bloat, which is accurate as far as it goes, but the operational cost is a review queue that somebody has to work.

Where it is the wrong tool, and what the alternatives look like

This is heavier than most teams need. If you want a reusable instruction for yourself, the README's own guidance is to create, verify, and install it privately with no marketplace setup, and at that scale the governance machinery is overhead. If your workflow is a single deterministic transformation, a script plus a test suite covers it without a skill package, evals, or a release process. The clearer comparison is with the underlying standards the project builds on. The Agent Skills Open Standard defines what a skill is; Agent Skills Platform adds the build, validation, security checks, and marketplace around that format. Plain MCP servers solve a different problem: they expose capabilities to an agent, while this project organizes capabilities and knowledge into a governed path toward a verified outcome. A general eval framework will measure your prompts but will not produce an installable package with ownership, approvals, versioned releases, rollback, quarantine, and compatibility evidence. The trade-off is that you are adopting a full lifecycle with roles attached: an SME who owns business meaning and an operator who owns distribution and policy. Without both roles filled, the marketplace half of the product does nothing.

Versioning, licence, and what to check before you commit

The repository is MIT licensed, which permits commercial and internal use with the usual attribution and warranty terms; that is a summary of the identifier, not legal advice, and your counsel should review anything you redistribute. The badge in the README shows version 6.1.0, and no releases were retrieved, so treat the version as a repository state rather than a published artifact with a changelog you can audit. The repository is not archived and the last push shown is 2026-09-03. Upgrade cost is the least documented area. The README describes rollback and quarantine as marketplace capabilities, which suggests versioned releases are the intended upgrade mechanism, but it does not describe a migration path for skills built against an earlier version, nor how a pinned data contract is re-validated when an upstream API changes. Those are the two things to ask about before standardizing on it. For a concrete starting point, the repository ships a read-only weather briefing example with a source-linked result; the README points to docs/verification/2026-08-27-live-weather-briefing.md and references/examples/live-weather-briefing-skill. Inspecting that package is the fastest way to judge whether the artifact this tool produces matches what your team would actually maintain.

Editorial conclusion

Adopt it if you have a recurring decision workflow with real evidence behind it and a team that needs to install the same approved version, with an operator who will run the marketplace. Do not adopt it if you want a single prompt file, or if nobody will own approvals and quarantine. Verify first that your agent is among the 17 supported install targets in docs/INSTALL.md, that the marketplace repository you intend to govern is one you control, and that Semantic Recon is acceptable for your data, since install.sh --without-semantic-recon disables the pinned data contract.

Official sources

  1. FrancyJGLisboa/agent-skills-platform on GitHub
  2. Issues
  3. License: MIT
  4. Project website
  5. README
Community notes

Community notes