algorand-devrel/algorand-project-setup
skills/algorand-project-setup/SKILL.md
Scaffolds Algorand projects using AlgoKit CLI, manages LocalNet, and retrieves code examples from official GitHub repositories. Use when initializing projects with algokit init, running build/test/deploy commands, starting or resetting LocalNet, or searching for Algorand contract examples and patterns.
$ install --global
skillsauthnpx skillsauth add algorand-devrel/algorand-agent-skills algorand-project-setupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 3, 2026, 12:15 PM11.5s4 files scanned
SKILL.md
- name:
- algorand-project-setup
- description:
- Scaffolds Algorand projects using AlgoKit CLI, manages LocalNet, and retrieves code examples from official GitHub repositories. Use when initializing projects with algokit init, running build/test/deploy commands, starting or resetting LocalNet, or searching for Algorand contract examples and patterns.
AlgoKit Project Setup & Examples
Quick Start
# Install AlgoKit
pipx install algokit
# Create a fullstack project — smart contracts + React frontend (default)
algokit init -n my-project -t fullstack --answer preset_name production --answer contract_template typescript --defaults
# Development cycle
cd my-project
algokit project run build # Compile contracts
algokit project run test # Run tests
algokit localnet start # Start local network
algokit project deploy localnet # Deploy
Reference Guide
Creating Projects
Initialize new Algorand projects using AlgoKit templates and presets.
- project-templates.md — Templates, presets, CLI flags, and customization options
CLI Commands
Build, test, deploy, and manage LocalNet with AlgoKit CLI.
- cli-commands.md — Full CLI command reference and workflow
Searching Examples
Find working contract examples from Algorand Foundation repositories using GitHub tools.
- github-search-tools.md — GitHub MCP tools, priority repos, search patterns
Important Rules
- Always confirm with user before running
algokit init - Default to fullstack template (
-t fullstack) with TypeScript contracts and production preset — MUST pass--answer contract_template typescriptsince the default is Python - Always build before testing — tests use generated clients
- Search algorandfoundation repos first — official, vetted examples
Canonical Example Repos
| Repository | Best For |
|------------|----------|
| algorandfoundation/devportal-code-examples | Beginner-friendly contract examples (TypeScript + Python) |
| algorandfoundation/puya-ts | Advanced TypeScript contract examples |
| algorandfoundation/puya | Advanced Python contract examples |
| algorandfoundation/algokit-fullstack-template | Fullstack project template (contracts + React) |
Always fetch corresponding test files alongside contract examples.
Cross-References
algorand-core— AVM mental model, transaction types, protocol conceptsalgorand-typescript/algorand-python— Contract development syntax and patternsalgorand-frontend— React frontend integration and wallet connection
Related Skills
algorand-devrel/algokit-utils-ts
tools
VerifiedTrustedCommunity
Guide for writing TypeScript code with AlgoKit Utils (`@algorandfoundation/algokit-utils`). Use this skill whenever the user is building on Algorand with TypeScript — client setup, account management, payments, asset operations, atomic transaction groups, smart contract deployment and interaction (AppFactory, AppClient, ARC-56/ARC-32 specs), raw app calls, key registration, network management, testing with algorandFixture, error handling, and the low-level crypto primitives under `@algorandfoundation/algokit-utils/crypto` (Ed25519 keygen/signing/verification, SHA-512/256 `hash`, Peikert xHD BIP44 wallets, wrapped-secret patterns). Trigger on imports from `@algorandfoundation/algokit-utils` (incl. `/crypto`, `/testing`, `/transact` subpaths), references to `AlgorandClient`, `AppFactory`, `AppClient`, `AlgoAmount`, `algorandFixture`, `ed25519Generator`, `peikertXHdWalletGenerator`, `hash`, `WrappedEd25519Seed`, or `RawEd25519Signer`. Also on any TypeScript or JavaScript code that builds on Algorand.
31SKILL.mdUpdated May 14, 2026
algorand-devrel/algokit-utils-py
tools
VerifiedTrustedCommunity
Guide for writing Python code with AlgoKit Utils (`algokit-utils`). Use this skill whenever the user is building on Algorand with Python — client setup, account management, payments, ASA operations, atomic transaction groups, smart contract deployment and interaction (AppFactory, AppClient, ARC-56/ARC-32 specs), raw app calls, TEAL compilation, key registration, network management, error handling, and the low-level crypto primitives in `algokit_crypto` (Ed25519 keygen/signing/verification, Peikert xHD BIP44 wallets, wrapped-secret patterns) and `algokit_common` (`sha512_256`). Trigger on imports from `algokit_utils` or `algokit_crypto`, references to `AlgorandClient`, `AppFactory`, `AppClient`, `AlgoAmount`, `ed25519_generator`, `peikert_hd_wallet_generator`, `sha512_256`, `WrappedEd25519Seed`, or `RawEd25519Signer`, or any Python code that builds on Algorand.
31SKILL.mdUpdated May 14, 2026
algorand-devrel/algorand-x402-typescript
tools
VerifiedTrustedCommunity
Builds x402 HTTP-native payment applications on Algorand using TypeScript. Covers clients (fetch, axios), servers (Express, Hono), facilitators, paywalls, Next.js integration, and the @x402-avm core library. Use when implementing x402 payment flows in TypeScript, creating payment-gated APIs, building x402 facilitators or paywalls, or integrating @x402-avm packages.
30SKILL.mdUpdated Apr 3, 2026
algorand-devrel/algorand-x402-python
tools
VerifiedTrustedCommunity
Builds x402 HTTP-native payment applications on Algorand using Python. Covers clients (httpx, requests), servers (FastAPI, Flask), facilitators, Bazaar discovery, and the x402-avm core library. Use when implementing x402 payment flows in Python, creating payment-gated APIs, building x402 facilitators, or integrating x402-avm packages.
30SKILL.mdUpdated Apr 3, 2026