All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog.
npx skills addnow discovers all 12 skills by default. Previously, the top-levelSKILL.mdrouter shadowed nested skills underskills/*/SKILL.md, sonpx skills add digitalocean-labs/do-app-platform-skills(and--list,--skill '*') only returned the router — not the 12 skills the README/blog advertised. The rootSKILL.mdnow setsmetadata.internal: true, which tells theskillsCLI to skip the router during enumeration so the 12 sub-skills surface without needing--full-depth. Verified locally:npx skills add ./ --listnow reports "Found 12 skills". (ESC-24068)
shared/skill-schema.json: added optionalmetadataobject (withmetadata.internal: boolean) to the frontmatter schema so the validator accepts the router's new field. Additional metadata keys are permitted so future CLI-side fields don't require schema churn.
- Skills Versioning System
- Added
version: 1.0.0to all 12 SKILL.md files - Added
min_doctl_version: "1.82.0"to all skills - Added
related_skillsarray for dependency tracking - Added
deprecatedfield for lifecycle management
- Added
- Skill Schema Validation
- Created
shared/skill-schema.jsonJSON Schema for SKILL.md validation - Created
scripts/validate_skills.pyvalidation script - Added
validate-skillsCI job to enforce schema compliance
- Created
- Versioning Policy in CONTRIBUTING.md
- Semantic versioning guidelines (MAJOR.MINOR.PATCH)
- Breaking change documentation requirements
- Deprecation Policy in CONTRIBUTING.md
- Skill deprecation workflow with
deprecated_messageandsunset_date - 30-day minimum sunset timeline
- Migration path requirements
- Skill deprecation workflow with
- API Compatibility Matrix in README.md
- doctl version requirements per skill
- App Spec version tracking
- Updated README with expanded version compatibility section
- Updated CI workflow to include skill validation
- Updated CONTRIBUTING.md with SKILL.md requirements
- Contributing guidelines
- CHANGELOG.md
- Updated README with version compatibility matrix
- Comprehensive test suite with 70% code coverage
test_migration/- Migration script teststest_postgres/- PostgreSQL helper teststest_security/- Security validation (SQL injection, credential handling)test_validation/- App spec and configuration validationtest_edge_cases/- Edge case and error handling teststest_workflows/- End-to-end workflow teststest_shared/- Shared configuration tests
- CI/CD pipeline with GitHub Actions (
test.yml,ci.yml)- Multi-OS matrix (Ubuntu, macOS)
- Multi-Python matrix (3.11, 3.12, 3.13)
- Codecov integration for coverage reporting
- Test infrastructure files
pytest.ini- pytest configurationrequirements-dev.txt- development dependenciesconftest.py- shared test fixtures
- Contributing guidelines (CONTRIBUTING.md)
- Added credential pattern documentation
- Added security scanning in CI
- Security tests for SQL injection prevention
- Credential handling validation tests
- Initial release with 11 specialized skills:
designer- Natural language to App Specdeployment- GitHub Actions CI/CDmigration- Platform migrationpostgres- PostgreSQL configurationmanaged-db-services- MySQL, MongoDB, Valkey, Kafkanetworking- Domains, routing, CORS, VPCspaces- S3-compatible storageai-services- Gradient AI inferencetroubleshooting- Debug and diagnosticsdevcontainers- Local developmentsandbox- Isolated executionplanner- Staged project planning
- Shared configuration files
- Python helper scripts
- Architecture documentation
- Pre-release for internal testing
- Container images on personal account (to be migrated)