The dominant model for sharing knowledge with AI agents is broken by design. You write a prompt, a workflow, a data recipe, or a system instruction. You store it on a platform — a SaaS tool, a chat interface, a note-taking app. It lives there, locked to your account, invisible to others, and gone the moment the platform changes its terms or shuts down.
The problem is not that knowledge is being created. The problem is that it cannot circulate. Every practitioner rediscovers the same patterns from scratch. Every team re-invents the same agent workflows. Every organisation accumulates knowledge in silos that evaporate when people leave or platforms pivot.
HyperSkills — the format defined at hyperskills.net — is a minimal, radical answer to this problem. A hyperskill is a URL that contains the skill, not a link to a skill stored elsewhere. The knowledge artifact is encoded directly in the URL parameter ?hs=. It requires no server to host, no account to access, and no platform permission to share.
Le modèle dominant pour partager des connaissances avec des agents IA est cassé par conception. On écrit un prompt, un workflow, une recette de données, une instruction système. On le stocke sur une plateforme — un outil SaaS, une interface de chat, une appli de notes. Ça vit là, verrouillé à un compte, invisible pour les autres, et disparu dès que la plateforme change ses conditions ou ferme.
Le problème n'est pas que la connaissance est créée. Le problème est qu'elle ne peut pas circuler. Chaque praticien redécouvre les mêmes patterns depuis zéro. Chaque équipe réinvente les mêmes workflows agents. Chaque organisation accumule de la connaissance dans des silos qui s'évaporent quand les gens partent ou que les plateformes pivotent.
HyperSkills — le format défini sur hyperskills.net — est une réponse minimale et radicale à ce problème. Une hyper-recette (hyperskill) est une URL qui contient la recette (skill), pas un lien vers une recette (skill) stockée ailleurs. L'artefact de connaissance est encodé directement dans le paramètre d'URL ?hs=. Pas de serveur pour héberger, pas de compte pour accéder, pas de permission de plateforme pour partager.
What is a hyperskill Qu'est-ce qu'une hyper-recette (hyperskill)
The concept is deliberately simple. A hyperskill is a URL with a ?hs= parameter containing the base64-encoded content of a skill. The content is free-form — Markdown, SQL, YAML, HTML, plain text, or any structured format. The URL's origin (the domain and path before the ?hs=) identifies the context where the skill was created and is meant to be used.
Le concept est délibérément simple. Une hyper-recette (hyperskill) est une URL avec un paramètre ?hs= contenant le contenu d'une recette (skill) encodé en base64. Le contenu est libre — Markdown, SQL, YAML, HTML, texte brut, ou n'importe quel format structuré. L'origine de l'URL (le domaine et le chemin avant ?hs=) identifie le contexte dans lequel la recette (skill) a été créée et est destinée à être utilisée.
?hs=. Prefix gz. or br. for compressed skills. With compression, 250–500 KB fits in ~32,000 characters.?hs=. Préfixe gz. ou br. pour les recettes (skills) compressées. Avec compression, 250–500 Ko tient en ~32 000 caractères.The format is intentionally agnostic about content. A hyperskill can be a SQL recipe for querying parliamentary data (as on tricoteuses.fr), a Markdown guide for analysing legal texts, a YAML workflow for an AI agent, or a structured UI composition. The URL origin provides the context; the ?hs= parameter carries the knowledge. Two examples show the range:
Le format est intentionnellement agnostique sur le contenu. Une hyper-recette (hyperskill) peut être une recette SQL pour interroger des données parlementaires (comme sur tricoteuses.fr), un guide Markdown pour analyser des textes juridiques, un workflow YAML pour un agent IA, ou une composition UI structurée. L'origine de l'URL fournit le contexte ; le paramètre ?hs= transporte la connaissance. Deux exemples illustrent l'étendue du format :
Why skills are digital commons Pourquoi les recettes (skills) sont des communs numériques
Digital commons theory, built on Elinor Ostrom's work and adapted for the web, identifies three conditions for a resource to be a commons: it must be non-excludable (no one can be prevented from using it), non-rival (one person's use doesn't diminish another's), and collectively governed rather than controlled by a single owner who can restrict or monetise access unilaterally.
A hyperskill satisfies all three conditions structurally — not by political declaration, but because the format makes it impossible to be otherwise. It is non-excludable because it lives in a URL anyone with the link can open. It is non-rival because sharing a recipe doesn't degrade it — a thousand people can use the same skill simultaneously without anyone being worse off. And it has no central owner because the content lives in the URL itself, not on any server that could be taken down, paywalled, or acquired.
La théorie des communs numériques, construite sur les travaux d'Elinor Ostrom et adaptée au web, identifie trois conditions pour qu'une ressource soit un commun : elle doit être non-exclusive (personne ne peut en être exclu), non-rivale (l'usage par l'un ne diminue pas celui de l'autre), et gouvernée collectivement plutôt que contrôlée par un propriétaire unique pouvant restreindre ou monétiser l'accès unilatéralement.
Une hyper-recette (hyperskill) satisfait ces trois conditions structurellement — pas par déclaration politique, mais parce que le format rend impossible qu'il en soit autrement. Elle est non-exclusive parce qu'elle vit dans une URL que quiconque possédant le lien peut ouvrir. Elle est non-rivale parce que partager une recette ne la dégrade pas — mille personnes peuvent utiliser la même skill simultanément sans que personne ne soit lésé. Et elle n'a pas de propriétaire central parce que le contenu vit dans l'URL elle-même, pas sur un serveur qui pourrait être fermé, mis derrière un paywall ou racheté.
What circulates as a common is not an interface, not a tool — it's procedural knowledge: how to query this dataset, how to structure this workflow, how to compose this view.
Ce qui circule comme commun, ce n'est pas une interface, pas un outil — c'est de la connaissance procédurale : comment interroger ce jeu de données, structurer ce workflow, composer cette vue.
This is what distinguishes a hyperskill from a shareable document. A recipe shared as a PDF or a GitHub Gist is a common in spirit — you can copy it and distribute it. But it requires a platform to host it (GitHub, Google Drive, a file server), an account to access it in many cases, and a human to retrieve and apply it manually. A hyperskill is executable by an agent: loading it means the agent can immediately use the knowledge it encodes. The skill is simultaneously its own documentation and its own delivery mechanism.
C'est ce qui distingue une hyper-recette (hyperskill) d'un document partageable. Une recette partagée en PDF ou comme GitHub Gist est un commun dans l'esprit — on peut la copier et la distribuer. Mais elle nécessite une plateforme pour l'héberger (GitHub, Google Drive, un serveur de fichiers), souvent un compte pour y accéder, et un humain pour la récupérer et l'appliquer manuellement. Une hyper-recette (hyperskill) est exécutable par un agent : la charger signifie que l'agent peut immédiatement utiliser la connaissance qu'elle encode. La recette (skill) est simultanément sa propre documentation et son propre mécanisme de livraison.
Traceability without a central authority Traçabilité sans autorité centrale
One objection to URL-encoded content is trust: how do you know the skill hasn't been tampered with? How do you track versions? How do you establish authorship? HyperSkills answers all three questions with cryptography, not with a platform.
The SHA-256 hash is computed over the source URL concatenated with the content. This means the same content published at two different URLs produces two different hashes — provenance is part of identity. A hash mismatch tells you immediately that the URL, the content, or both have changed since the hash was computed.
Version chaining works like Git commits: each version of a skill can embed the hash of the previous one in its metadata. Following the chain reconstructs the full history of a recipe without any central repository. Any tool implementing the format can verify the chain locally.
Ed25519 signatures let authors sign their hashes. The signature is optional — HyperSkills work without it — but it provides a strong proof of authorship for skills where that matters (legal, medical, institutional knowledge).
Une objection au contenu encodé dans l'URL est la confiance : comment savoir que la recette (skill) n'a pas été falsifiée ? Comment tracer les versions ? Comment établir la paternité ? HyperSkills répond à ces trois questions par la cryptographie, pas par une plateforme.
Le hash SHA-256 est calculé sur la concaténation de l'URL source et du contenu. Cela signifie que le même contenu publié à deux URLs différentes produit deux hashes différents — la provenance fait partie de l'identité. Un hash incohérent indique immédiatement que l'URL, le contenu, ou les deux ont changé depuis le calcul du hash.
Le chaînage de versions fonctionne comme les commits Git : chaque version d'une recette (skill) peut embarquer le hash de la précédente dans ses métadonnées. Suivre la chaîne reconstitue l'historique complet d'une recette sans dépôt central. N'importe quel outil implémentant le format peut vérifier la chaîne localement.
Les signatures Ed25519 permettent aux auteurs de signer leurs hashes. La signature est optionnelle — les HyperSkills fonctionnent sans — mais elle fournit une preuve forte de paternité pour les recettes (skills) où c'est important (connaissance juridique, médicale, institutionnelle).
# Hyperskill traceability — all optional but chainable# Traçabilité HyperSkill — tout optionnel mais chaînable hash: a3f7c2d9e1b84f6c… # SHA-256(source_url + content)# SHA-256(url_source + contenu) previousHash: 9b1e44f10c723a8d… # links to previous version# lien vers la version précédente signature: Ed25519:4a7f… # author signs the hash# l'auteur signe le hash
This architecture gives HyperSkills something rare: decentralised provenance. You can verify the origin and integrity of a skill without trusting any third party. The cryptography is the trust model.
Cette architecture donne aux HyperSkills quelque chose de rare : une provenance décentralisée. On peut vérifier l'origine et l'intégrité d'une recette (skill) sans faire confiance à un tiers. La cryptographie est le modèle de confiance.
A skill's lifecycle in practice Le cycle de vie d'une recette (skill) en pratique
The best existing example of HyperSkills in production is tricoteuses.fr — a civic tech platform for querying French parliamentary data. Its SQL recipes circulate as hyperskill URLs. A user who finds a recipe for analysing amendments can open it, see the full SQL in the viewer, adapt it to their needs, and share their modified version as a new URL. The chain of hashes connects all versions without any repository.
Another implementation — webmcp-auto-ui — shows what this looks like for UI compositions. A user connects the tool to any MCP server, asks a question in natural language, and gets a dashboard assembled from typed blocks (stat cards, charts, tables, timelines). They can then export the entire composition as a hyperskill: the block structure, the data, the MCP server URL, the LLM context, all encoded in a single sharable URL. A colleague opens the URL, gets the same composition against their own data, modifies it, and reshares.
Le meilleur exemple existant de HyperSkills en production est tricoteuses.fr — une plateforme civic tech pour interroger les données parlementaires françaises. Ses recettes SQL circulent sous forme d'URLs hyperskill. Un utilisateur qui trouve une recette pour analyser les amendements peut l'ouvrir, voir le SQL complet dans le viewer, l'adapter à ses besoins, et partager sa version modifiée comme nouvelle URL. La chaîne de hashes relie toutes les versions sans aucun dépôt.
Une autre implémentation — webmcp-auto-ui — montre à quoi ça ressemble pour des compositions UI. Un utilisateur connecte l'outil à n'importe quel serveur MCP, pose une question en langage naturel, et obtient un tableau de bord assemblé depuis des blocs typés (stat cards, graphiques, tableaux, timelines). Il peut ensuite exporter la composition complète comme hyperskill : la structure des blocs, les données, l'URL du serveur MCP, le contexte LLM, le tout encodé dans une seule URL partageable. Un collègue ouvre l'URL, obtient la même composition sur ses propres données, la modifie, et la repartage.
How HyperSkills compare to existing approaches Comparaison avec les approches existantes
Every existing approach to sharing AI knowledge has a platform dependency built in. HyperSkills removes it.
Toutes les approches existantes de partage de connaissance IA ont une dépendance de plateforme intégrée. HyperSkills la supprime.
| Approach | Approche | Self-contained | Autoportant | No platform | Sans plateforme | Versionable | Versionnable | Agent-executable | Exécutable agent |
|---|---|---|---|---|---|---|---|---|---|
| HyperSkill URL | Yes | Yes | Hash chainChaîne de hash | Yes | |||||
| GitHub Gist / file | GitHub Gist / fichier | No | GitHub | Git | No | ||||
| Claude Artifacts | Claude Artifacts | No | claude.ai | No | PartialPartiel | ||||
| MCP server resource | Ressource serveur MCP | No | Server requiredServeur requis | DependsDépend | Yes | ||||
| Agent Skills folder | Dossier Agent Skills | No | File systemSystème de fichiers | Git | Yes | ||||
| Prompt library (SaaS) | Bibliothèque de prompts (SaaS) | No | Vendor lock-inEnfermement vendeur | If availableSi disponible | PartialPartiel |
The closest relative to a hyperskill is an Agent Skills folder — a directory of instructions and scripts that agents can load. Agent Skills is the recommended format for the content of a hyperskill. But a folder requires a file system or a repository. A hyperskill is the URL-portable version: the same knowledge, no infrastructure required.
Le plus proche parent d'une hyper-recette (hyperskill) est un dossier Agent Skills — un répertoire d'instructions et de scripts que les agents peuvent charger. Agent Skills est le format recommandé pour le contenu d'une hyper-recette (hyperskill). Mais un dossier nécessite un système de fichiers ou un dépôt. Une hyperskill en est la version portable par URL : la même connaissance, sans infrastructure requise.
Building with HyperSkills Construire avec HyperSkills
The spec is at hyperskills.net, which also includes a live encoder/decoder. Any application can add hyperskill support with a few dozen lines of code: read the ?hs= parameter on page load, base64-decode it (and decompress if prefixed gz. or br.), parse the content, and display or execute it. Encoding goes the other direction: serialise, compress if large, base64-encode, append to the current URL.
La spec est sur hyperskills.net, qui inclut aussi un encodeur/décodeur interactif. N'importe quelle application peut ajouter le support des hyper-recettes (hyperskills) en quelques dizaines de lignes de code : lire le paramètre ?hs= au chargement de la page, décoder le base64 (et décompresser si préfixe gz. ou br.), parser le contenu, l'afficher ou l'exécuter. L'encodage va dans l'autre sens : sérialiser, compresser si volumineux, encoder en base64, appender à l'URL courante.
// Minimal decode — works in any browser// Décodage minimal — fonctionne dans n'importe quel navigateur async function decodeHyperSkill(url) { const param = new URL(url).searchParams.get('hs'); if (!param) return null; if (param.startsWith('gz.')) { // gzip-compressed skill// skill compressée en gzip const binary = Uint8Array.from(atob(param.slice(3)), c => c.charCodeAt(0)); const ds = new DecompressionStream('gzip'); ds.writable.getWriter().write(binary); return await new Response(ds.readable).text(); } return decodeURIComponent(escape(atob(param))); }
webmcp-auto-ui is one example of a complete implementation. It adds hyperskill support to a Svelte 5 application that connects to MCP servers, composes UI dashboards via an agent loop, and exports the full composition — block structure, data, server URL, LLM context — as a hyperskill. Its SDK package (@webmcp-auto-ui/sdk) implements the full format including hash chaining, compression, and diff. But it is one implementation among many: any application, in any language, on any platform, can read and write hyperskills.
webmcp-auto-ui est un exemple d'implémentation complète. Il ajoute le support des hyper-recettes (hyperskills) à une application Svelte 5 qui se connecte à des serveurs MCP, compose des tableaux de bord UI via une boucle agent, et exporte la composition complète — structure des blocs, données, URL du serveur, contexte LLM — comme hyperskill. Son package SDK (@webmcp-auto-ui/sdk) implémente le format complet incluant chaînage de hash, compression et diff. Mais c'est une implémentation parmi d'autres : n'importe quelle application, dans n'importe quel langage, sur n'importe quelle plateforme, peut lire et écrire des hyper-recettes (hyperskills).