dynamic-skills 0.1.0__tar.gz

dynamic_skills-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: CI
+
+on:
+  push:
+    branches: [main, 'feat/**']
+  pull_request:
+  workflow_dispatch:
+  workflow_call:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: ${{ matrix.os }} / Python ${{ matrix.python }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python: ['3.11', '3.13']
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v10.0.1
+        with:
+          python-version: ${{ matrix.python }}
+          enable-cache: true
+      - run: uv sync --locked --group dev
+      - run: uv run ruff check src tests scripts
+      - run: uv run ruff format --check src tests scripts
+      - run: uv run pytest --cov=dynamic_skills --cov-report=term-missing
+      - run: uv build
+      - run: uv run python scripts/check_dist.py
+      - run: uvx --from twine twine check --strict dist/*
+      - name: Smoke test installed wheel and sdist
+        shell: bash
+        run: |
+          for artifact in dist/*.whl dist/*.tar.gz; do
+            uv run --isolated --no-project --with "$artifact" python scripts/smoke_install.py
+          done
+      - name: Preserve verified release distributions
+        if: matrix.os == 'ubuntu-latest' && matrix.python == '3.11'
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: distributions
+          path: dist/
+          if-no-files-found: error

dynamic_skills-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,92 @@
+name: Release
+
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          fetch-depth: 0
+      - name: Require a release tag on main
+        env:
+          RELEASE_REF: ${{ github.ref }}
+        run: |
+          [[ "$RELEASE_REF" =~ ^refs/tags/v[0-9]+\.[0-9]+\.[0-9]+$ ]]
+          git merge-base --is-ancestor HEAD origin/main
+
+  checks:
+    needs: validate
+    uses: ./.github/workflows/ci.yml
+
+  publish:
+    needs: checks
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/dynamic-skills/
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v10.0.1
+        with:
+          python-version: '3.11'
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: distributions
+          path: dist/
+      - name: Verify tag and distribution versions
+        env:
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: uv run --no-project python scripts/check_dist.py "$RELEASE_TAG"
+      - name: Reject conflicting files on retries
+        run: uv run --no-project python scripts/check_pypi.py
+      - name: Publish to PyPI using Trusted Publishing
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          skip-existing: true
+
+  github-release:
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: distributions
+          path: dist/
+      - name: Publish GitHub release and checksums
+        env:
+          GH_TOKEN: ${{ github.token }}
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: |
+          sha256sum dist/* > SHA256SUMS
+          python - <<'PY'
+          import os
+          from pathlib import Path
+          version = os.environ['RELEASE_TAG'][1:]
+          text = Path('CHANGELOG.md').read_text()
+          notes = text.split(f'## [{version}]', 1)[1].split('\n## [', 1)[0]
+          Path('release-notes.md').write_text(notes.strip() + '\n')
+          PY
+          if ! gh release view "$RELEASE_TAG" >/dev/null 2>&1; then
+            gh release create "$RELEASE_TAG" --verify-tag --draft \
+              --title "$RELEASE_TAG (Alpha)" --notes-file release-notes.md
+          fi
+          gh release upload "$RELEASE_TAG" dist/* SHA256SUMS --clobber
+          gh release edit "$RELEASE_TAG" --draft=false --latest

dynamic_skills-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+dist/
+*.egg-info/
+.code-review-graph/
+.codegraph/
+.vscode/

dynamic_skills-0.1.0/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+## [0.1.0]
+
+First public release of Dynamic Skills (`dskills`), an Alpha CLI for a versioned
+local skill pool and explicit project skill selection.
+
+### Included
+
+- Import local and Git skills with complete resources, content hashes and provenance.
+- Activate pinned skills for Codex, Claude Code, Kimi Code and Pi; preview changes,
+  synchronize project outputs, unplug skills and undo project changes.
+- Preserve unmanaged files and local edits, with process locks, transactional
+  writes and explicit interrupted-operation recovery.
+- Inventory and migrate global skills with reversible backups and restore support.
+- Organize skills with tags/categories, additive reusable packages and pinned presets.
+- Search and read skills through a versioned JSON CLI interface and an optional
+  bundled bridge skill; inspect local operation statistics and health diagnostics.
+- Keep project metadata local by default, with opt-in Git tracking of configuration
+  and exact lockfile pins.
+
+### Compatibility and limitations
+
+- Python 3.11+; automated CI covers Linux, macOS and Windows on Python 3.11 and 3.13.
+- Both `dskills` and `dynamic-skills` are supported CLI entry points.
+- JSON responses use `schema_version: 1`. Alpha releases may change interfaces or
+  metadata formats; consult release notes before upgrading and retain backups.
+- Native agent discovery depends on agent versions and configuration. Removing a
+  skill does not erase instructions already loaded into a conversation.
+- Local source paths are not inherently portable. Cross-filesystem migration with
+  deactivation is unsupported; symlink mode depends on filesystem permissions.
+- No skill scripts run on import, activation or reading. Imported skills retain
+  their own licenses; execution and trust remain the user's responsibility.
+
+[0.1.0]: https://github.com/M1racleShih/dynamic-skills/releases/tag/v0.1.0

dynamic_skills-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 M1racleShih
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.