Surface the developer skill on docs.autonomi.com and as a Claude Code plugin

.claude-plugin/marketplace.json

@@ -0,0 +1,26 @@
+{
+  "name": "withautonomi",
+  "description": "Plugins and skills for building on the Autonomi Network.",
+  "owner": {
+    "name": "Autonomi"
+  },
+  "plugins": [
+    {
+      "name": "developer",
+      "source": "./",
+      "description": "Build, integrate, and deploy applications on the Autonomi Network with verified guidance for the SDK, CLI, Direct Rust, and MCP paths.",
+      "homepage": "https://docs.autonomi.com/developers/developer-skill",
+      "repository": "https://github.com/WithAutonomi/autonomi-developer-docs",
+      "license": "MIT",
+      "keywords": [
+        "autonomi",
+        "ant-sdk",
+        "antd",
+        "ant-client",
+        "ant-core",
+        "mcp",
+        "decentralized-storage"
+      ]
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "developer",
+  "description": "Build, integrate, and deploy applications on the Autonomi Network with verified guidance for the SDK, CLI, Direct Rust, and MCP paths.",
+  "author": {
+    "name": "Autonomi"
+  },
+  "homepage": "https://docs.autonomi.com/developers/developer-skill",
+  "repository": "https://github.com/WithAutonomi/autonomi-developer-docs",
+  "license": "MIT"
+}

component-registry.yml

@@ -32,7 +32,7 @@ components:
       - reference/source-repositories.md
       - reference/glossary.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   openapi:
     repo: ant-sdk
@@ -43,7 +43,7 @@ components:
     feeds_pages:
       - sdk/reference/rest-api.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   proto:
     repo: ant-sdk
@@ -54,7 +54,7 @@ components:
     feeds_pages:
       - sdk/reference/grpc-services.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   ant-dev:
     repo: ant-sdk
@@ -69,7 +69,7 @@ components:
       - guides/set-up-a-local-network.md
       - guides/test-your-application.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-mcp:
     repo: ant-sdk
@@ -85,7 +85,7 @@ components:
       - mcp/mcp-server-reference.md
       - sdk/reference/overview.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-rust:
     repo: ant-sdk
@@ -97,7 +97,7 @@ components:
       - sdk/reference/language-bindings/overview.md
       - sdk/reference/language-bindings/rust.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-py:
     repo: ant-sdk
@@ -109,7 +109,7 @@ components:
       - sdk/reference/language-bindings/overview.md
       - sdk/reference/language-bindings/python.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-js:
     repo: ant-sdk
@@ -122,7 +122,7 @@ components:
       - sdk/reference/language-bindings/javascript.md
       - sdk/reference/language-bindings/typescript.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-go:
     repo: ant-sdk
@@ -134,7 +134,7 @@ components:
       - sdk/reference/language-bindings/overview.md
       - sdk/reference/language-bindings/go.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-java:
     repo: ant-sdk
@@ -145,7 +145,7 @@ components:
     feeds_pages:
       - sdk/reference/language-bindings/java.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-csharp:
     repo: ant-sdk
@@ -156,7 +156,7 @@ components:
     feeds_pages:
       - sdk/reference/language-bindings/csharp.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-kotlin:
     repo: ant-sdk
@@ -167,7 +167,7 @@ components:
     feeds_pages:
       - sdk/reference/language-bindings/kotlin.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-swift:
     repo: ant-sdk
@@ -178,7 +178,7 @@ components:
     feeds_pages:
       - sdk/reference/language-bindings/swift.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-ruby:
     repo: ant-sdk
@@ -189,7 +189,7 @@ components:
     feeds_pages:
       - sdk/reference/language-bindings/ruby.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-php:
     repo: ant-sdk
@@ -200,7 +200,7 @@ components:
     feeds_pages:
       - sdk/reference/language-bindings/php.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-cpp:
     repo: ant-sdk
@@ -211,7 +211,7 @@ components:
     feeds_pages:
       - sdk/reference/language-bindings/cpp.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-dart:
     repo: ant-sdk
@@ -222,7 +222,7 @@ components:
     feeds_pages:
       - sdk/reference/language-bindings/dart.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-zig:
     repo: ant-sdk
@@ -233,7 +233,7 @@ components:
     feeds_pages:
       - sdk/reference/language-bindings/zig.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   antd-elixir:
     repo: ant-sdk
@@ -282,7 +282,7 @@ components:
       - reference/source-repositories.md
       - reference/glossary.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   ant-cli:
     repo: ant-client
@@ -302,7 +302,7 @@ components:
       - reference/source-repositories.md
       - reference/glossary.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   # === ant-node ===
 
@@ -324,7 +324,7 @@ components:
       - reference/source-repositories.md
       - reference/glossary.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   ant-devnet:
     repo: ant-node
@@ -337,7 +337,7 @@ components:
       - guides/set-up-a-local-network.md
       - guides/test-your-application.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   # === Foundational single-crate repos ===
 
@@ -396,7 +396,7 @@ components:
       - reference/source-repositories.md
       - reference/glossary.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   self_encryption:
     repo: self_encryption
@@ -413,7 +413,7 @@ components:
       - reference/source-repositories.md
       - reference/glossary.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   evmlib:
     repo: evmlib
@@ -428,7 +428,7 @@ components:
       - sdk/how-to-guides/use-external-signers-for-upload-payments.md
       - reference/source-repositories.md
     feeds_skills:
-      - skills/autonomi-developer/SKILL.md
+      - skills/start/SKILL.md
 
   ant-merkle:
     repo: ant-merkle

docs/SUMMARY.md

@@ -1,6 +1,7 @@
 # Table of contents
 
 * [What is Autonomi?](index.md)
+* [Use the Autonomi Developer Skill](developer-skill.md)
 
 ## Core Concepts
 

docs/developer-skill.md

@@ -0,0 +1,65 @@
+# Use the Autonomi Developer Skill
+
+<!-- verification:
+  source_repo: ant-sdk
+  source_ref: main
+  source_commit: 1cbfb3e92cb4309f29e92b5609837812027f0a67
+  verified_date: 2026-04-30
+  verification_mode: current-merged-truth
+-->
+
+The Autonomi Developer Skill is a verified knowledge package for AI coding tools such as Claude Code. It is a companion to these docs, not a replacement, and gives your AI coding tool the operational expertise it needs to help you build, integrate, and deploy applications on the Autonomi Network.
+
+**Preview release.** The skill is currently in a draft state. Install names and identifiers may shift before the first non-draft version.
+
+## What it gives your AI
+
+- **Autonomi development expertise**, including how to choose the right path for your project across the SDK, CLI, Direct Rust, and MCP.
+- **Access to verified API surfaces, golden flows, and common-failure recipes**, so your AI works from real endpoints, real CLI commands, and real method names instead of guessing.
+- **Safety rules around wallets, keys, uploads, and public-network work**, so it defaults to a local devnet first and asks before touching real Autonomi Network Token (ANT).
+
+## Install it
+
+### In Claude Code
+
+Run these commands inside Claude Code to add the Autonomi marketplace and install the skill:
+
+```text
+/plugin marketplace add WithAutonomi/autonomi-developer-docs
+/plugin install developer@withautonomi
+/reload-plugins
+```
+
+The skill is now available across all your Claude Code sessions. Claude uses it automatically when you work on Autonomi tasks. To invoke it explicitly, type `/developer:start`.
+
+### In other AI tools
+
+Any tool that loads Claude-style skill files can read it directly from the canonical URL:
+
+```text
+https://raw.githubusercontent.com/WithAutonomi/autonomi-developer-docs/main/skills/start/SKILL.md
+```
+
+Follow your tool's instructions for installing a Markdown skill file.
+
+### Manual install
+
+To install the skill by hand into Claude Code, drop the file into your Claude Code skills directory:
+
+```bash
+mkdir -p ~/.claude/skills/autonomi-developer
+curl -fsSL https://raw.githubusercontent.com/WithAutonomi/autonomi-developer-docs/main/skills/start/SKILL.md \
+  -o ~/.claude/skills/autonomi-developer/SKILL.md
+```
+
+## Staying current
+
+The skill checks for newer published versions on each use and tells you when one is available so you can refresh your local copy. The verified upstream commits are recorded in the skill's metadata, so you can always see exactly which versions of the Autonomi source repos a given copy of the skill was verified against.
+
+## Related pages
+
+- [What is Autonomi?](index.md)
+- [Build with the SDKs](sdk/install.md)
+- [Use the CLI](cli/use-the-cli.md)
+- [Developing in Rust](rust/README.md)
+- [Use MCP with AI Tools](mcp/use-mcp-with-ai-tools.md)

docs/index.md

@@ -73,6 +73,10 @@ Build directly in Rust when you want in-process control over networking, uploads
 
 Start with [Developing in Rust](rust/README.md).
 
+## Build with an AI coding tool
+
+If you are working in Claude Code or another AI coding tool, install the [Autonomi Developer Skill](developer-skill.md). It gives your tool a verified, focused guide to building on Autonomi, so it picks the right path, uses real APIs, and avoids common mistakes.
+
 ## Core concepts
 
 - [Data Types](core-concepts/data-types.md)

skills/autonomi-developer/CHANGELOG.md → skills/start/CHANGELOG.md

@@ -1,9 +1,12 @@
-# Changelog - autonomi-developer skill
+# Changelog - Autonomi Developer Skill
 
 All notable changes to this skill are recorded here.
 
 ## [Unreleased]
 
+### Changed
+- Moved the skill from `skills/autonomi-developer/` to `skills/start/` so the namespaced slash form is `/developer:start` instead of `/autonomi-developer:autonomi-developer`. Plugin identifier is now `developer` and the marketplace identifier is `withautonomi`. Internal `name:` and `skill:` fields and canonical URLs updated to match.
+
 ## [0.1.1-draft] - 2026-04-30
 
 ### Changed

skills/autonomi-developer/MAINTAINING.md → skills/start/MAINTAINING.md

@@ -1,6 +1,6 @@
-# Maintaining the `autonomi-developer` skill
+# Maintaining the Autonomi Developer Skill
 
-This skill lives in `skills/autonomi-developer/` and follows the same source-of-truth model as the rest of the docs repo.
+This skill lives in `skills/start/` (slash-invoked as `/developer:start` after install via the `withautonomi` marketplace) and follows the same source-of-truth model as the rest of the docs repo.
 
 ## Files that move together
 

skills/autonomi-developer/SKILL.md → skills/start/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: autonomi-developer
+name: start
 description: |
   Build applications, automations, and AI workflows on the Autonomi Network.
   Use this skill when the user wants to store or retrieve data, add Autonomi
@@ -39,7 +39,7 @@ verified_commits:
   self_encryption: 5f9d1646231da7ca2ce60e84d010acfb6d9c29d0
   evmlib: 225acbb1af613193bcc8264b6ede4d7e4a7ac607
 
-version_manifest_url: https://raw.githubusercontent.com/WithAutonomi/autonomi-developer-docs/main/skills/autonomi-developer/version.json
+version_manifest_url: https://raw.githubusercontent.com/WithAutonomi/autonomi-developer-docs/main/skills/start/version.json
 canonical_docs_url: https://docs.autonomi.com/developers
 ---
 
@@ -71,7 +71,7 @@ Do not use this skill for:
 1. Check whether a newer verified version of this skill exists:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/WithAutonomi/autonomi-developer-docs/main/skills/autonomi-developer/version.json
+curl -fsSL https://raw.githubusercontent.com/WithAutonomi/autonomi-developer-docs/main/skills/start/version.json
 ```
 
 If the published `version` is newer, tell the user this copy may be stale and offer to reload it. If the fetch fails, continue silently. For an unpublished draft, that usually means the skill is not on `main` yet.