From algorand-plugin
Comprehensive guide for Algorand TypeScript (PuyaTs) smart contract development — syntax rules, migration, testing, deployment, React frontends, AlgoKit Utils, ARC standards, and troubleshooting. This is the parent skill for all TypeScript-specific Algorand content. Use when writing TypeScript contract code, encountering Puya compiler errors, migrating from TEALScript or beta, testing contracts with Vitest, deploying with typed clients, building React frontends, or using AlgoKit Utils in TypeScript. Strong triggers include "Puya compiler error", "uint64", "clone()", "BoxMap", ".algo.ts", "migrate from TEALScript", "algorandFixture", "vitest", "deploy contract", "call method", "React frontend", "use-wallet", "AlgorandClient TypeScript", "npm install algokit-utils".
How this skill is triggered — by the user, by Claude, or both
Slash command
/algorand-plugin:algorand-typescriptThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This is the aggregated parent skill for all TypeScript-specific Algorand development. Use the reference files below to find detailed guidance for each topic.
references/algorand-ts-migration-from-beta.mdreferences/algorand-ts-migration-from-tealscript.mdreferences/algorand-ts-migration.mdreferences/algorand-typescript-syntax-methods-and-abi.mdreferences/algorand-typescript-syntax-reference.mdreferences/algorand-typescript-syntax-storage.mdreferences/algorand-typescript-syntax-transactions.mdreferences/algorand-typescript-syntax-types-and-values.mdreferences/algorand-typescript-syntax.mdreferences/build-smart-contracts-reference.mdreferences/build-smart-contracts.mdreferences/call-smart-contracts-reference.mdreferences/call-smart-contracts.mdreferences/create-project-reference.mdreferences/create-project.mdreferences/deploy-react-frontend-examples.mdreferences/deploy-react-frontend-reference.mdreferences/deploy-react-frontend.mdreferences/implement-arc-standards-arc32-arc56.mdreferences/implement-arc-standards-arc4.mdThis is the aggregated parent skill for all TypeScript-specific Algorand development. Use the reference files below to find detailed guidance for each topic.
# Create TypeScript project
algokit init -n my-project -t typescript --answer preset_name production --defaults
# Install AlgoKit Utils
npm install @algorandfoundation/algokit-utils
# Development cycle
algokit project run build # Compile .algo.ts contracts
algokit project run test # Run Vitest tests
Contract files must use .algo.ts extension. Use AVM types (uint64, bytes), never JavaScript number. Always clone() complex types.
Navigate to the appropriate reference based on your task. Each topic has one or more files.
Critical syntax rules for Algorand TypeScript (PuyaTs) that prevent compiler errors.
Migrate from TEALScript or Algorand TypeScript Beta to 1.0.
Write integration and unit tests using algorandFixture and Vitest.
Deploy and interact with contracts using generated TypeScript clients.
Build React frontends with wallet integration and typed contract clients.
Initialize TypeScript AlgoKit projects with proper templates and presets.
TypeScript-specific contract building with PuyaTs.
Interact with Algorand from TypeScript applications.
TypeScript implementations of ARC-4, ARC-32, and ARC-56.
TypeScript-specific error diagnosis and fixes.
| Topic | Files | Description |
|---|---|---|
| Syntax Rules | 6 | PuyaTs types, storage, methods, transactions |
| Migration | 3 | TEALScript and beta migration guides |
| Testing | 3 | Vitest integration and unit tests |
| Calling Contracts | 2 | Deployment and typed client interaction |
| React Frontends | 3 | Wallet integration and dApp UI |
| Create Project | 2 | TypeScript template initialization |
| Build Contracts | 2 | TypeScript-focused contract building |
| AlgoKit Utils | 2 | AlgorandClient TypeScript API |
| ARC Standards | 3 | TypeScript ARC implementations |
| Troubleshoot | 3 | TypeScript error fixes |
.md file for step-by-step guidancealgorand-development parent skillnpx claudepluginhub goplausible/claude-algorand-plugin --plugin algorand-pluginScans TEAL and PyTeal Algorand smart contracts for 11 vulnerabilities including rekeying attacks, unchecked fees, missing validations, and access control issues. Use for pre-audit security checks.
Implements reference architecture for Alchemy-powered Web3 dApps: multi-chain clients, React/Next.js frontend, API endpoints, webhooks, caching, and project structure.
Use this skill when an agent needs real, compilable examples of Compact smart contracts, TypeScript witnesses, or tests. Covers beginner contracts (counter, bulletin board), reusable modules (access control, security, tokens, math, crypto, data structures, identity, utils), composed token contracts (fungible, NFT, multi-token, shielded), and full applications (CryptoKitties, ZK lending, real-world assets). All examples compile with pragma language_version >= 0.22 and full proof generation.