diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 0000000..d38b263 --- /dev/null +++ b/.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" + ] + } + ] +} diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..64dcc2a --- /dev/null +++ b/.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" +} diff --git a/component-registry.yml b/component-registry.yml index 7641568..d7a2f73 100644 --- a/component-registry.yml +++ b/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 diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 19c3705..dc33ca3 100644 --- a/docs/SUMMARY.md +++ b/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 diff --git a/docs/developer-skill.md b/docs/developer-skill.md new file mode 100644 index 0000000..6fce23d --- /dev/null +++ b/docs/developer-skill.md @@ -0,0 +1,65 @@ +# Use the Autonomi Developer Skill + + + +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) diff --git a/docs/index.md b/docs/index.md index f9c6348..c1b924a 100644 --- a/docs/index.md +++ b/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) diff --git a/skills/autonomi-developer/CHANGELOG.md b/skills/start/CHANGELOG.md similarity index 83% rename from skills/autonomi-developer/CHANGELOG.md rename to skills/start/CHANGELOG.md index ee999ac..edaaaa6 100644 --- a/skills/autonomi-developer/CHANGELOG.md +++ b/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 diff --git a/skills/autonomi-developer/MAINTAINING.md b/skills/start/MAINTAINING.md similarity index 94% rename from skills/autonomi-developer/MAINTAINING.md rename to skills/start/MAINTAINING.md index 9322592..cb9566f 100644 --- a/skills/autonomi-developer/MAINTAINING.md +++ b/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 diff --git a/skills/autonomi-developer/SKILL.md b/skills/start/SKILL.md similarity index 99% rename from skills/autonomi-developer/SKILL.md rename to skills/start/SKILL.md index 33b7ac1..644a126 100644 --- a/skills/autonomi-developer/SKILL.md +++ b/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. diff --git a/skills/autonomi-developer/version.json b/skills/start/version.json similarity index 90% rename from skills/autonomi-developer/version.json rename to skills/start/version.json index ea61aa9..19b4b0f 100644 --- a/skills/autonomi-developer/version.json +++ b/skills/start/version.json @@ -1,9 +1,9 @@ { - "skill": "autonomi-developer", + "skill": "start", "version": "0.1.1-draft", "published_date": "2026-04-30", "status": "draft", - "canonical_skill_url": "https://raw.githubusercontent.com/WithAutonomi/autonomi-developer-docs/main/skills/autonomi-developer/SKILL.md", + "canonical_skill_url": "https://raw.githubusercontent.com/WithAutonomi/autonomi-developer-docs/main/skills/start/SKILL.md", "canonical_docs_url": "https://docs.autonomi.com/developers", "repository": "https://github.com/WithAutonomi/autonomi-developer-docs", "verification_mode": "current-merged-truth",