{"id":43933005,"url":"https://github.com/digitalocean-labs/do-app-platform-skills","last_synced_at":"2026-02-07T00:19:27.969Z","repository":{"id":331271034,"uuid":"1124066896","full_name":"digitalocean-labs/do-app-platform-skills","owner":"digitalocean-labs","description":"Claude/Agent Skills for DigitalOcean App Platform - deployment, migration, networking, database configuration, and troubleshooting","archived":false,"fork":false,"pushed_at":"2026-01-31T00:05:44.000Z","size":323,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-31T15:50:09.415Z","etag":null,"topics":["ai-skills","app-platform","claude","deployment","devops","digitalocean","paas"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/digitalocean-labs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-28T08:54:16.000Z","updated_at":"2026-01-31T00:05:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/digitalocean-labs/do-app-platform-skills","commit_stats":null,"previous_names":["bikramkgupta/do-app-platform-skills","digitalocean-labs/do-app-platform-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/digitalocean-labs/do-app-platform-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalocean-labs%2Fdo-app-platform-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalocean-labs%2Fdo-app-platform-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalocean-labs%2Fdo-app-platform-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalocean-labs%2Fdo-app-platform-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digitalocean-labs","download_url":"https://codeload.github.com/digitalocean-labs/do-app-platform-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalocean-labs%2Fdo-app-platform-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29181326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T23:15:33.022Z","status":"ssl_error","status_checked_at":"2026-02-06T23:15:09.128Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-skills","app-platform","claude","deployment","devops","digitalocean","paas"],"created_at":"2026-02-07T00:19:27.285Z","updated_at":"2026-02-07T00:19:27.957Z","avatar_url":"https://github.com/digitalocean-labs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DigitalOcean App Platform Skills\n\n[![Tests](https://github.com/bikramkgupta/do-app-platform-skills/actions/workflows/test.yml/badge.svg)](https://github.com/bikramkgupta/do-app-platform-skills/actions/workflows/test.yml)\n[![codecov](https://codecov.io/gh/bikramkgupta/do-app-platform-skills/graph/badge.svg)](https://codecov.io/gh/bikramkgupta/do-app-platform-skills)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\nClaude/Agent skills for DigitalOcean App Platform - deployment, migration, networking, database configuration, and troubleshooting.\n\n## Version Compatibility\n\n### Tool Requirements\n\n| Tool | Minimum Version | Recommended | Notes |\n|------|-----------------|-------------|-------|\n| doctl | 1.82.0+ | 1.100.0+ | App spec v2 support |\n| Python | 3.11+ | 3.12+ | For scripts |\n| Node.js | 20+ | 22+ | LTS versions |\n| PostgreSQL | 15+ | 16 | Default: 16 |\n\n### Skills Version\n\nAll skills in this repository are versioned. Check each skill's frontmatter for:\n- `version`: Semantic version (MAJOR.MINOR.PATCH)\n- `min_doctl_version`: Minimum doctl CLI version required\n\n```yaml\n# Example from SKILL.md frontmatter\n---\nname: app-platform-designer\nversion: 1.0.0\nmin_doctl_version: \"1.82.0\"\n---\n```\n\n### API Compatibility Matrix\n\n| Skills Version | doctl Version | App Spec Version | Status |\n|----------------|---------------|------------------|--------|\n| 1.0.x | 1.82.0+ | v2 | ✅ Current |\n\n### Checking Your doctl Version\n\n```bash\ndoctl version\n# doctl version 1.100.0-release\n\n# Update if needed\nbrew upgrade doctl  # macOS\nsnap refresh doctl  # Linux\n```\n\n## What Are Skills?\n\nSkills are structured prompts and documentation that help AI assistants (like Claude) perform specialized tasks. Each skill contains domain knowledge, best practices, code patterns, and decision trees for a specific area of App Platform.\n\n## Prerequisites\n\nBefore using these skills, ensure you have:\n\n| Tool | Required | Purpose |\n|------|----------|---------|\n| **doctl** | ✅ Yes | DigitalOcean CLI for deployments and management |\n| **DO API Token** | ✅ Yes | Authentication ([create one here](https://cloud.digitalocean.com/account/api/tokens)) |\n| **git** | ✅ Yes | Clone repos, manage deployments |\n| **gh** | Optional | GitHub CLI for creating repos, PRs, workflows |\n| **docker** | Optional | Local testing, building container images |\n\n### Quick Setup\n\n```bash\n# Install doctl (macOS)\nbrew install doctl\n\n# Or on Linux\nsnap install doctl\n\n# Authenticate with your API token\ndoctl auth init\n\n# Verify it works\ndoctl account get\n```\n\n## Getting Started\n\n### Step 1: Set Up Skills Directory\n\nCreate a skills directory for your AI assistant of choice:\n\n```bash\n# For Claude Code\nmkdir -p ~/.claude/skills\n\n# For Codex\nmkdir -p ~/.codex/skills\n\n# For Cursor\nmkdir -p ~/.cursor/skills\n\n# Or in your project root\nmkdir -p .claude/skills\n```\n\n### Step 2: Clone This Repository\n\n```bash\n# Clone into your skills directory\ncd ~/.claude/skills  # or your preferred location\ngit clone https://github.com/bikramkgupta/do-app-platform-skills.git\n\n# Or clone into your project\ncd your-project\ngit clone https://github.com/bikramkgupta/do-app-platform-skills.git .claude/skills/do-app-platform\n```\n\n### Step 3: Start Using Skills\n\nJust describe what you want and ask to use App Platform skills:\n\n```\n\"I want to deploy my Python FastAPI app with PostgreSQL. Use the App Platform skills.\"\n\n\"Migrate my Heroku app to DigitalOcean. Use App Platform skills to help.\"\n\n\"My app is crashing on startup. Use App Platform troubleshooting skills to debug.\"\n```\n\n### For Complex Tasks\n\nFor larger projects, ask for a detailed plan:\n\n```\n\"I need to set up a multi-service architecture with API, worker, and database.\nUse App Platform skills and create a detailed plan in the /plan folder before implementing.\"\n```\n\nThis creates structured plan files you can review before execution.\n\n## Example Prompts\n\n| What You Want | Example Prompt |\n|--------------|----------------|\n| **Create a new app** | \"Create an App Spec for my Node.js API with Redis caching. Use App Platform skills.\" |\n| **Migrate from Heroku** | \"Migrate this Heroku app to App Platform. Use the migration skill.\" |\n| **Troubleshoot issues** | \"My database connections are timing out. Use App Platform troubleshooting to diagnose.\" |\n| **Set up CI/CD** | \"Set up GitHub Actions to deploy on push to main. Use deployment skills.\" |\n| **Configure networking** | \"I need custom domain with SSL and CORS headers. Use networking skills.\" |\n| **Database setup** | \"Configure PostgreSQL with connection pooling for my Django app. Use postgres skills.\" |\n\n## Available Skills\n\n| Skill | Description | Key Artifacts |\n|-------|-------------|---------------|\n| [**designer**](skills/designer/) | Natural language → production-ready App Spec | `.do/app.yaml` |\n| [**deployment**](skills/deployment/) | GitHub Actions CI/CD and deployment workflows | `.github/workflows/` |\n| [**migration**](skills/migration/) | Migrate from Heroku, AWS, Docker Compose, etc. | `.do/app.yaml`, checklist |\n| [**networking**](skills/networking/) | Domains, routing, CORS, VPC, static IPs | App spec snippets |\n| [**postgres**](skills/postgres/) | PostgreSQL configuration, security, multi-tenant | SQL scripts |\n| [**managed-db-services**](skills/managed-db-services/) | MySQL, MongoDB, Valkey, Kafka, OpenSearch | App spec snippets |\n| [**spaces**](skills/spaces/) | S3-compatible object storage | CORS config |\n| [**ai-services**](skills/ai-services/) | Gradient AI serverless inference | App spec snippets |\n| [**troubleshooting**](skills/troubleshooting/) | Debug running apps with container access | Diagnostic reports |\n| [**devcontainers**](skills/devcontainers/) | Local development with production parity | `.devcontainer/` |\n\n## Alternative Usage Methods\n\n### With Claude Projects (claude.ai)\n\n1. Create a new Claude Project\n2. Add the relevant `SKILL.md` files to the project knowledge\n3. Start chatting about your App Platform needs\n\n### Direct Context Injection\n\nCopy the contents of any `SKILL.md` file into your conversation with any AI assistant as context.\n\n## Philosophy\n\nThese skills are **opinionated playbooks**, not documentation replicas:\n\n- They make decisions (VPC by default, GitHub Actions for CI/CD)\n- They generate artifacts (app specs, workflows, scripts)\n- They defer to docs only for edge cases\n- They never handle credentials directly\n\n**Key principle**: Skills only contain DO-specific knowledge the LLM doesn't have from training.\n\n## Skill Structure\n\n```\nskills/\n├── skill-name/\n│   ├── README.md      # Quick overview and when to use\n│   ├── SKILL.md       # Concise router (150-350 lines)\n│   ├── reference/     # Detailed docs (loaded on-demand)\n│   ├── templates/     # (optional) Reusable templates\n│   └── scripts/       # (optional) Helper scripts\n```\n\n## Skill Dependency Graph\n\n```\n                    ┌─────────────┐\n                    │  designer   │\n                    └──────┬──────┘\n                           │ produces .do/app.yaml\n                           ▼\n┌─────────────┐     ┌─────────────┐     ┌───────────────┐\n│  migration  │────▶│ deployment  │────▶│troubleshooting│\n└─────────────┘     └─────────────┘     └───────────────┘\n\n    ┌──────────┐  ┌────────────┐  ┌────────────┐\n    │ postgres │  │managed-db  │  │ networking │\n    └──────────┘  └────────────┘  └────────────┘\n         └──────────────┼──────────────┘\n                        ▼\n             (referenced by designer)\n```\n\n## Credential Safety\n\nAll skills follow this priority:\n\n1. **GitHub Secrets** — Recommended, agent never sees credentials\n2. **Bindable Variables** — `${db.DATABASE_URL}` injected automatically\n3. **External Systems** — User manages entirely\n\n## Contributing\n\nContributions welcome! Please:\n\n1. Follow the existing skill structure\n2. Include practical examples and code snippets\n3. Document limitations and gotchas\n4. Test with Claude before submitting\n\n## License\n\nMIT License - See [LICENSE](LICENSE) for details.\n\n## Resources\n\n- [App Platform Documentation](https://docs.digitalocean.com/products/app-platform/)\n- [App Spec Reference](https://docs.digitalocean.com/products/app-platform/reference/app-spec/)\n- [doctl CLI](https://docs.digitalocean.com/reference/doctl/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalocean-labs%2Fdo-app-platform-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitalocean-labs%2Fdo-app-platform-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalocean-labs%2Fdo-app-platform-skills/lists"}