skills/go-project-and-api-design/skill.json

{"schema_version":2,"collection":"engineering-skills-for-go","display_name":"Go Project and API Design","short_description":"Shape packages, APIs, and dependencies","default_prompt":"Use $go-project-and-api-design to design this Go package or API boundary.","version":"0.2.0","maturity":"beta","category":"design","risk_domains":["compatibility","maintainability","testability"],"tags":["go","packages","modules","api","dependencies","releases"],"go_versions":{"minimum":"1.24","guidance":["1.25","1.26"]},"claim_ids":["eng-dependency-direction","eng-api-compatibility"],"relations":{"complements":["go-language-engineering","go-service-boundaries"],"overlaps":[]},"compatibility_evidence":[{"client":"codex","level":"behaviorally-benchmarked","contract":"OpenAI skill plus agents/openai.yaml and committed eval artifacts","verified_on":"2026-08-18"},{"client":"claude-code","level":"structurally-compatible","contract":"Claude plugin skill layout and manifest validation","verified_on":"2026-08-18"},{"client":"cursor","level":"structurally-compatible","contract":"Agent Plugin and .cursor/skills layout validation","verified_on":"2026-08-18"},{"client":"opencode","level":"structurally-compatible","contract":".agents/skills layout and portable frontmatter validation","verified_on":"2026-08-18"}],"source_provenance":{"method":"independent-rewrite-from-primary-evidence","reference_repositories":["cc-skills-golang","cxuu-golang-skills","go-skills","gophers"],"corpus_lock":"research/corpus-lock.json"},"sources":[{"title":"Organizing a Go module","url":"https://go.dev/doc/modules/layout","publisher":"The Go Authors","kind":"primary","verified_on":"2026-08-18","supports":["module layout","internal packages","commands"]},{"title":"Go Modules Reference","url":"https://go.dev/ref/mod","publisher":"The Go Authors","kind":"normative","verified_on":"2026-08-24","supports":["module graph","toolchain","major version suffixes","versioning"]},{"title":"Module release and versioning workflow","url":"https://go.dev/doc/modules/release-workflow","publisher":"The Go Authors","kind":"primary","verified_on":"2026-08-24","supports":["release types","pre-releases","breaking releases"]},{"title":"Go 1 and the Future of Go Programs","url":"https://go.dev/doc/go1compat","publisher":"The Go Authors","kind":"normative","verified_on":"2026-08-24","supports":["Go 1 compatibility scope","tool and performance exclusions"]},{"title":"Keeping Your Modules Compatible","url":"https://go.dev/blog/module-compatibility","publisher":"The Go Authors","kind":"primary","verified_on":"2026-08-24","supports":["additive API evolution","compatibility techniques"]}]}