build-smart-contracts

Build Algorand smart contracts with Puya TypeScript or Python using AlgoKit workflows.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/gabrielkuettel/vibegallery --skill build-smart-contracts-gabrielkuettel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-smart-contracts
Source: https://github.com/gabrielkuettel/vibegallery/tree/main/.claude/skills/build-smart-contracts
Command: npx skills add https://github.com/gabrielkuettel/vibegallery --skill build-smart-contracts-gabrielkuettel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Build Algorand smart contracts using Puya TypeScript or Puya Python—enabling teams to jumpstart contracts from scratch, apply features, and follow architecture patterns with guided examples and tests.

Core Features & Use Cases

  • Guidance-driven workflow: search official docs, retrieve canonical examples, adapt code to requirements, and include integration tests.
  • End-to-end contract development: generate, build, and test contracts using Puya workflows and AlgoKit commands.
  • Real-world use cases: starting new contracts, adding methods to existing contracts, and implementing common patterns like ARC4 ABI methods, state management, and inner transactions.

Quick Start

Choose your language (TypeScript or Python), reference canonical Puya examples, adapt to your requirements, and run the Algokit build and test workflow.

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 with Puya?

You can build Algorand smart contracts with Puya by selecting TypeScript or Python, retrieving canonical examples, adapting code to requirements, and running the AlgoKit build and test workflow.

What is the best way to start a new Algorand smart contract?

Starting a new Algorand smart contract is best done using Puya TypeScript by default, avoiding legacy PyTEAL or Beaker tools, and adapting canonical examples from priority repositories.

Can I use Python to write Algorand smart contracts with AlgoKit?

Yes, you can use Puya Python to write Algorand smart contracts within the AlgoKit workflow, though the guidance defaults to TypeScript for canonical integration.

Does Puya support adding ARC4 ABI methods and state management to existing contracts?

Yes, Puya supports adding ARC4 ABI methods, state management, and inner transactions to existing Algorand contracts by adapting canonical examples and including integration tests.

Why should I avoid PyTEAL and Beaker when developing Algorand smart contracts?

PyTEAL and Beaker are considered legacy tools, whereas Puya provides the modern canonical TypeScript and Python workflows for Algorand smart contract development.

How do I test Algorand smart contracts built with Puya?

You test Algorand smart contracts built with Puya by including integration tests and executing the AlgoKit build and test workflow to validate contract features.