build-smart-contracts

Design and implement Algorand PuyaTs/PuyaPy smart contracts from concept to deployment.

2|Updated Jul 29, 2025
One-click install
npx skills add https://github.com/algorandfoundation/xgov-committees --skill build-smart-contracts-algorandfoundation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-smart-contracts
Source: https://github.com/algorandfoundation/xgov-committees/tree/main/.claude/skills/build-smart-contracts
Command: npx skills add https://github.com/algorandfoundation/xgov-committees --skill build-smart-contracts-algorandfoundation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides structured guidance for building Algorand Puya-based smart contracts (TypeScript PuyaTs and Python PuyaPy), covering architecture patterns, development workflows, and best practices.

Core Features & Use Cases

  • Step-by-step workflow for translating concepts into Puya-based contracts; includes references to canonical examples, tests, and deployment patterns.
  • Practical use cases: creating new contracts, adding features, refactoring patterns, and evaluating architecture decisions.
  • Example scenario: designing a voting contract or NFT contract with robust patterns.

Quick Start

Start by outlining your contract requirements and follow the Puya workflow to scaffold and implement the contract.

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?

To build Algorand smart contracts using Puya, you outline your contract requirements and follow a structured workflow to scaffold and implement PuyaTs or PuyaPy code. This process covers architecture patterns, deployment, and testing.

Does Puya support both TypeScript and Python for Algorand development?

Yes, Puya supports both TypeScript and Python for Algorand development. You can implement contracts using PuyaTs or PuyaPy, allowing you to design and deploy smart contracts in your preferred language environment.

What is the best way to structure an Algorand voting or NFT contract?

The best way to structure an Algorand voting or NFT contract is to apply canonical examples and robust architecture patterns. These patterns guide you in translating concepts into secure Puya contracts with reliable testing workflows.

How do I test and deploy Algorand Puya contracts?

You test and deploy Algorand Puya contracts by following established development workflows that include canonical examples and testing patterns. This ensures your PuyaTs or PuyaPy contract is robust before deployment.

Can I refactor existing Algorand smart contracts using Puya patterns?

Yes, you can refactor existing Algorand smart contracts using Puya patterns. The framework provides guidance on adding features, evaluating architecture decisions, and applying structured development workflows to improve your contracts.