build-smart-contracts

Design and implement Algorand smart contracts with Puya TS or PuyaPy.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/SomehowLiving/Acre --skill build-smart-contracts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-smart-contracts
Source: https://github.com/SomehowLiving/Acre/tree/main/.agents/skills/build-smart-contracts
Command: npx skills add https://github.com/SomehowLiving/Acre --skill build-smart-contracts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Puya TS and PuyaPy enable statically-typed Algorand smart contracts; this skill guides you from architecture to implementation and testing.

Core Features & Use Cases

  • Contract design guidance for new contracts and feature additions.
  • Pattern-aware implementation using Puya TS or PuyaPy with safe defaults.
  • Testing & verification patterns including integration tests and mocks for deterministic results.

Quick Start

Provide your contract goal and I will outline a Puya TS/PuyaPy plan and starter files.

Frequently Asked Questions about build-smart-contracts

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

FAQPage Schema
How do I build Algorand smart contracts using Puya TS or PuyaPy?

To build Algorand smart contracts with Puya TS or PuyaPy, define your contract goal, outline the architecture, generate starter files, implement with safe defaults, and verify using integration tests and mocks for deterministic results.

What are the testing patterns for Algorand smart contracts in TypeScript?

Algorand smart contract testing patterns include writing integration tests and utilizing mocks to ensure deterministic results and verify safe coding practices during contract execution.

Can I extend existing Algorand contracts with PuyaPy?

Yes, you can extend existing Algorand contracts with PuyaPy by following pattern-aware implementation guidance to safely add new features while maintaining statically-typed safe defaults.

Does Puya TS support statically-typed smart contract architecture guidance?

Yes, Puya TS supports statically-typed Algorand smart contract development by providing deterministic coding guidance, canonical examples, and architecture guidance for designing new contracts.

What's the best way to structure deterministic Algorand smart contracts?

The best way to structure deterministic Algorand smart contracts is to follow canonical examples and safe coding practices that ensure predictable execution and verifiable integration test results.

Why do I need mocks for Puya TS smart contract integration tests?

You need mocks for Puya TS smart contract integration tests to isolate contract logic and guarantee deterministic results by controlling external dependencies during verification.