feat: release version 1.0.0 with updated build workflow and CLI command name

Author: airscripts

.github/workflows/build.yml

@@ -10,12 +10,47 @@ jobs:
 
     steps:
       - uses: actions/checkout@v6
+        name: Checkout Code
+
       - uses: actions/setup-python@v6
+        name: Setup Python
 
         with:
           python-version: "3.10"
 
       - run: python -m pip install --upgrade pip
+        name: Upgrade pip
+
       - run: python -m pip install -e '.[dev]'
-      - run: python -m agentskill.main --help
-      - run: agentskill --help
+        name: Install Dependencies
+
+      - run: python -m pip install build twine
+        name: Install Build Tools
+
+      - run: python -m build --sdist --wheel --no-isolation
+        name: Build Package
+
+      - run: python -m twine check dist/*
+        name: Check Distribution
+
+      - run: python -m venv /tmp/agentskill-build-venv
+        name: Create Virtual Environment
+
+      - run: /tmp/agentskill-build-venv/bin/pip install dist/agsk-*.whl
+        name: Install Built Package
+
+      - run: /tmp/agentskill-build-venv/bin/agentskill --help
+        name: Test CLI
+
+      - run: /tmp/agentskill-build-venv/bin/agentskill analyze examples/python --pretty
+        name: Test Analyze
+
+      - run: /tmp/agentskill-build-venv/bin/agentskill generate examples/python > /tmp/generated-AGENTS.md
+        name: Test Generate
+
+      - uses: actions/upload-artifact@v4
+        name: Upload Distribution
+
+        with:
+          name: dist
+          path: dist/*

.github/workflows/release.yml

@@ -0,0 +1,68 @@
+name: Release
+
+on:
+  push:
+    tags: ["*"]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  verify:
+    name: Verify
+    uses: ./.github/workflows/verify.yml
+
+  build:
+    name: Build
+    needs: verify
+    uses: ./.github/workflows/build.yml
+
+  test:
+    name: Test
+    needs: build
+    uses: ./.github/workflows/test.yml
+
+  deploy:
+    name: Deploy
+    needs: test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+        name: Checkout Code
+
+      - uses: actions/setup-python@v6
+        name: Setup Python
+
+        with:
+          python-version: "3.10"
+
+      - name: Validate Tag
+
+        run: |
+          python - <<'PY'
+          import tomllib
+          from pathlib import Path
+
+          with Path("pyproject.toml").open("rb") as f:
+              version = tomllib.load(f)["project"]["version"]
+
+          expected = f"refs/tags/{version}"
+          actual = "${{ github.ref }}"
+
+          if actual != expected:
+              raise SystemExit(
+                  f"tag/version mismatch: expected {expected}, got {actual}"
+              )
+          PY
+
+      - uses: actions/download-artifact@v4
+        name: Download Distribution
+
+        with:
+          name: dist
+          path: dist
+
+      - name: Deploy
+        uses: pypa/gh-action-pypi-publish@release/v1

.gitignore

@@ -7,3 +7,8 @@ __pycache__/
 .codex
 .coverage
 agentskill.egg-info/
+dist/
+build/
+.mypy_cache/
+*.egg-info/
+*.egg

CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.0] - 2026-05-01
+
+### Added
+
+- Verified source and wheel build flow for the packaged `agentskill` runtime
+- Verified install-from-artifact smoke path for `agentskill --help`, `analyze`, and `generate`
+- Tag-triggered GitHub Actions publish workflow for PyPI releases
+
+### Changed
+
+- Bumped packaged version to `1.0.0`
+- Renamed the published PyPI distribution to `agsk` while preserving the `agentskill` CLI command
+- Reference metadata emitted by reference-aware generation now reports the `1.0.0` agentskill version
+- Finalized milestone release notes around the stable CLI contract, packaged runtime layout, direct `generate`, incremental `update`, reference-aware generation, interactive gap filling, verified language matrix, and PyPI distribution
+
 ## [0.10.0] - 2026-04-30
 
 ### Changed

README.md

@@ -33,9 +33,11 @@ Analyzer output feeds directly into `AGENTS.md` synthesis. The synthesis step fo
 ## Install
 
 ```bash
-pip install agentskill
+pip install agsk
 ```
 
+This installs the `agentskill` CLI command.
+
 For local development:
 
 ```bash

agentskill/lib/reference_initialization.py

@@ -17,7 +17,7 @@
     ReferenceMetadata,
 )
 
-AGENTSKILL_VERSION = "0.5.0"
+AGENTSKILL_VERSION = "1.0.0"
 
 
 def successful_reference_documents(

pyproject.toml

@@ -3,9 +3,10 @@ requires = ["setuptools>=68"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "agentskill"
-version = "0.10.0"
+name = "agsk"
+version = "1.0.0"
 description = "Analyze repositories and synthesize AGENTS.md"
+readme = "README.md"
 requires-python = ">=3.10"
 
 dependencies = [