algorand-typescript

Apply Algorand TypeScript PuyaTs syntax rules to prevent compiler errors in smart contracts.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/KudbeeZero/Algo-Unify-Dev --skill algorand-typescript-kudbeezero
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: algorand-typescript
Source: https://github.com/KudbeeZero/Algo-Unify-Dev/tree/main/.claude/skills/algorand-typescript
Command: npx skills add https://github.com/KudbeeZero/Algo-Unify-Dev --skill algorand-typescript-kudbeezero

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Algorand TypeScript PuyaTs code can be error-prone due to AVM constraints and storage patterns. This knowledge base provides structured rules to prevent common mistakes and guide best practices for writing contract code.

Core Features & Use Cases

  • AVM types & value semantics: guidelines for using the correct AVM types (uint64, bytes, biguint) and clone() semantics.
  • Storage patterns: guidance on GlobalState, LocalState, BoxMap, and Box usage with safe read/write patterns.
  • Transactions & inner calls: best practices for group transactions, inner transactions, and method selectors.
  • Real-world scenario: apply rules to fix typical compilation errors and incorrect storage access in PuyaTs.

Quick Start

Open a PuyaTs project and apply these rules to prevent compiler errors and ensure correct storage patterns.

Frequently Asked Questions about algorand-typescript

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Algorand TypeScript PuyaTs compiler errors related to AVM types?

To fix Algorand TypeScript PuyaTs compiler errors, you must enforce correct AVM types like uint64, bytes, and biguint. The skill prevents compilation issues by restricting JavaScript numbers and guiding proper type usage across smart contract development scenarios.

When do I need to use clone() in PuyaTs smart contracts?

You need to use clone() in PuyaTs smart contracts during both reads and writes for complex AVM types. Applying clone() semantics prevents runtime issues and ensures correct value semantics when interacting with Algorand smart contract storage patterns.

What is the best way to handle GlobalState and BoxMap storage patterns in Algorand TypeScript?

The best way to handle GlobalState and BoxMap storage patterns in Algorand TypeScript is to apply safe read and write rules. Structured guidance ensures proper storage access, preventing incorrect state modifications and common runtime mistakes in PuyaTs.

How do I structure inner transactions and group transactions in Algorand TypeScript?

To structure inner transactions and group transactions in Algorand TypeScript, follow best practices for method selectors and transaction patterns. The skill provides specific guidance to ensure correct inner transaction handling and prevent execution failures in PuyaTs.

Why does my PuyaTs smart contract fail due to JavaScript number usage?

Your PuyaTs smart contract fails because AVM constraints require specific types instead of standard JavaScript numbers. This skill enforces a strict no JavaScript numbers rule, promoting correct AVM value semantics to prevent compiler errors and runtime issues.