1.0.0

Swift API Design Guidelines Skill v1.0.0

First stable release of the Swift API Design Guidelines Agent Skill.

Highlights

• Introduces a complete skill package for Swift API design review and implementation.
• Focuses on point-of-use clarity, naming, argument labels, terminology, documentation comments, and conventions.
• Provides structured workflows for reviewing code, improving existing APIs, and implementing new API surfaces.

Included in this release

• swift-api-design-guidelines-skill/SKILL.md with overview, decision tree, core guidelines, quick reference, checklist, references, and philosophy.
• swift-api-design-guidelines-skill/references/ with focused modules:
  • fundamentals.md
  • promote-clear-usage.md
  • strive-for-fluent-usage.md
  • use-terminology-well.md
  • general-conventions.md
  • parameters.md
  • argument-labels.md
  • special-instructions.md
• Root AGENTS.md defining authoring/maintenance standards for the skill.
• .claude-plugin/plugin.json and .claude-plugin/marketplace.json for Claude plugin distribution.
• Expanded README.md with usage instructions and reference structure block.
• New CONTRIBUTING.md with contribution workflow and quality standards.

Repository automation

• Added .github/copilot-instructions.md for repo-specific Copilot review guidance.
• Added .github/FUNDING.yml.
• Added README sync automation:
  • .github/scripts/sync-readme.js
  • .github/workflows/sync-readme-references.yml
• Added release automation:
  • .github/workflows/release.yml

Notes

• License: MIT
• This release establishes the baseline (1.0.0) for future incremental guideline and tooling updates.