@hagicode/skillsbase 0.1.0-dev.1.1.426f4b0

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@hagicode/skillsbase",
+  "version": "0.1.0-dev.1.1.426f4b0",
+  "description": "Managed skills repository CLI",
+  "license": "MIT",
+  "homepage": "https://github.com/HagiCode-org/skillsbase#readme",
+  "bugs": {
+    "url": "https://github.com/HagiCode-org/skillsbase/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HagiCode-org/skillsbase.git"
+  },
+  "type": "module",
+  "packageManager": "npm@10.9.2",
+  "bin": {
+    "skillsbase": "./bin/skillsbase.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "templates",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "clean": "rm -rf dist",
+    "cli": "node --import tsx ./src/cli-entry.ts",
+    "pack:check": "node ./scripts/verify-package.mjs",
+    "publish:resolve-dev-version": "node ./scripts/resolve-dev-version.mjs",
+    "publish:verify-readiness": "node ./scripts/verify-publish-readiness.mjs",
+    "publish:verify-release": "node ./scripts/verify-release-version.mjs",
+    "test": "node --import tsx --test ./tests/*.test.ts",
+    "smoke": "node --import tsx ./scripts/smoke.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "engines": {
+    "node": ">=22.12.0",
+    "npm": ">=10.9.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vite": "^8.0.0"
+  }
+}

package/templates/actions/skillsbase-manage/action.yml

@@ -0,0 +1,96 @@
+# Managed by skillsbase CLI.
+
+name: skillsbase-manage
+description: Run a managed add, remove, or sync operation for a skillsbase repository
+
+inputs:
+  node-version:
+    description: Node.js version used for maintenance
+    required: false
+    default: "{{NODE_VERSION}}"
+  operation:
+    description: Maintenance operation to run (`add`, `remove`, or `sync`)
+    required: true
+  skill-name:
+    description: Skill name for `add` or `remove`
+    required: false
+    default: ""
+  source:
+    description: Optional source key for `add` or `remove`
+    required: false
+    default: ""
+  allow-missing-sources:
+    description: Skip missing local roots during the operation
+    required: false
+    default: "false"
+  run-tests:
+    description: Whether to run npm test after the maintenance command
+    required: false
+    default: "true"
+
+runs:
+  using: composite
+  steps:
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ inputs.node-version }}
+        cache: npm
+
+    - name: Install dependencies
+      shell: bash
+      run: npm ci
+
+    - name: Upgrade npm
+      shell: bash
+      run: npm install --global npm@10.9.2
+
+    - name: Install skillsbase
+      shell: bash
+      run: npm install --global @hagicode/skillsbase
+
+    - name: Run maintenance command
+      shell: bash
+      env:
+        OPERATION: ${{ inputs.operation }}
+        SKILL_NAME: ${{ inputs.skill-name }}
+        SOURCE: ${{ inputs.source }}
+        ALLOW_MISSING_SOURCES: ${{ inputs.allow-missing-sources }}
+      run: |
+        set -euo pipefail
+
+        base_args=(--repo .)
+        if [[ "${ALLOW_MISSING_SOURCES}" == "true" ]]; then
+          base_args+=(--allow-missing-sources)
+        fi
+
+        case "${OPERATION}" in
+          add|remove)
+            if [[ -z "${SKILL_NAME}" ]]; then
+              echo "::error::skill-name is required when operation=${OPERATION}."
+              exit 1
+            fi
+
+            command=(skillsbase "${OPERATION}" "${SKILL_NAME}" "${base_args[@]}")
+            if [[ -n "${SOURCE}" ]]; then
+              command+=(--source "${SOURCE}")
+            fi
+            ;;
+          sync)
+            command=(skillsbase sync "${base_args[@]}")
+            ;;
+          *)
+            echo "::error::Unsupported operation: ${OPERATION}."
+            exit 1
+            ;;
+        esac
+
+        printf 'Running:'
+        printf ' %q' "${command[@]}"
+        printf '\n'
+        "${command[@]}"
+
+    - name: Run tests
+      if: ${{ inputs.run-tests == 'true' }}
+      shell: bash
+      run: npm test

package/templates/actions/skillsbase-sync/action.yml

@@ -0,0 +1,44 @@
+# Managed by skillsbase CLI.
+
+name: skillsbase-sync
+description: Validate a managed skillsbase repository and run sync in check mode
+
+inputs:
+  node-version:
+    description: Node.js version used for validation
+    required: false
+    default: "{{NODE_VERSION}}"
+  run-tests:
+    description: Whether to run npm test before sync --check
+    required: false
+    default: "true"
+
+runs:
+  using: composite
+  steps:
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ inputs.node-version }}
+        cache: npm
+
+    - name: Install dependencies
+      shell: bash
+      run: npm ci
+
+    - name: Upgrade npm
+      shell: bash
+      run: npm install --global npm@10.9.2
+
+    - name: Install skillsbase
+      shell: bash
+      run: npm install --global @hagicode/skillsbase
+
+    - name: Run tests
+      if: ${{ inputs.run-tests == 'true' }}
+      shell: bash
+      run: npm test
+
+    - name: Run sync check
+      shell: bash
+      run: skillsbase sync --check --repo .

package/templates/docs/maintainer-workflow.md

@@ -0,0 +1,32 @@
+<!-- Managed by skillsbase CLI. -->
+
+# Maintainer Workflow
+
+The maintainer flow is `init -> add/remove -> sync -> github_action`.
+
+## Lifecycle
+
+1. `skillsbase init`
+2. `skillsbase add <skill-name>` or `skillsbase remove <skill-name>`
+3. `skillsbase sync`
+4. `skillsbase github_action --kind all`
+
+## GitHub Maintenance Path
+
+Use `.github/workflows/skills-manage.yml` only for explicit non-interactive maintenance from GitHub UI.
+
+- `operation` chooses `add`, `remove`, or `sync`
+- `skill-name` is required for `add` and `remove`
+- `source` is optional and maps to `--source`
+- `allow-missing-sources` maps to `--allow-missing-sources`
+- `run-tests` controls the post-operation `npm test`
+- The workflow does not commit, push, or open pull requests
+
+## Notes
+
+- `sources.yaml` is the single source of truth.
+- `skills/` stores managed output only.
+- `.skill-source.json` records source and conversion metadata.
+- `skillsbase sync --check` validates drift without writing files.
+- If a source root is unavailable, use `skillsbase sync --allow-missing-sources` to skip it.
+- Local CLI commands remain the primary maintainer path.

package/templates/skills/README.md

@@ -0,0 +1,9 @@
+<!-- Managed by skillsbase CLI. -->
+
+# Managed Skills
+
+This directory contains managed skill output only.
+
+- Every skill directory must include `SKILL.md`
+- Every managed directory must include `.skill-source.json`
+- Do not edit managed files by hand; make changes in `sources.yaml` and the upstream source instead

package/templates/sources.yaml

@@ -0,0 +1,25 @@
+# Managed by skillsbase CLI.
+# This template documents the expected manifest shape. The CLI serializes the real file.
+version: 1
+skillsRoot: skills
+metadataFile: .skill-source.json
+managedBy: skillsbase
+remoteRepository: "{{REMOTE_REPOSITORY}}"
+staleCleanup: true
+skillsCliVersion: 1.4.8
+installAgent: codex
+sources:
+  - key: first-party
+    label: "First-party local skills"
+    kind: first-party
+    root: "{{FIRST_PARTY_ROOT}}"
+    targetPrefix: ""
+    include:
+      - "{{FIRST_PARTY_EXAMPLE}}"
+  - key: system
+    label: "Mirrored system skills"
+    kind: mirrored-system
+    root: "{{SYSTEM_ROOT}}"
+    targetPrefix: system-
+    include:
+      - "{{SYSTEM_EXAMPLE}}"

package/templates/workflows/skills-manage.yml

@@ -0,0 +1,54 @@
+# Managed by skillsbase CLI.
+
+name: Skills Manage
+
+on:
+  workflow_dispatch:
+    inputs:
+      operation:
+        description: Operation to run (`add`, `remove`, or `sync`)
+        required: true
+        type: choice
+        default: sync
+        options:
+          - add
+          - remove
+          - sync
+      skill-name:
+        description: Skill name for `add` or `remove`
+        required: false
+        type: string
+      source:
+        description: Optional source key for `add` or `remove`
+        required: false
+        type: string
+      allow-missing-sources:
+        description: Skip missing local roots during the operation
+        required: false
+        type: boolean
+        default: false
+      run-tests:
+        description: Run `npm test` after the maintenance command
+        required: false
+        type: boolean
+        default: true
+
+permissions:
+  contents: read
+
+jobs:
+  manage:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Run skillsbase maintenance
+        uses: ./.github/actions/skillsbase-manage
+        with:
+          node-version: {{NODE_VERSION}}
+          operation: ${{ inputs.operation }}
+          skill-name: ${{ inputs.skill-name }}
+          source: ${{ inputs.source }}
+          allow-missing-sources: ${{ inputs.allow-missing-sources }}
+          run-tests: ${{ inputs.run-tests }}

package/templates/workflows/skills-sync.yml

@@ -0,0 +1,30 @@
+# Managed by skillsbase CLI.
+
+name: Skills Sync
+
+on:
+  workflow_dispatch:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+concurrency:
+  group: skills-sync-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Run skillsbase validation
+        uses: ./.github/actions/skillsbase-sync
+        with:
+          node-version: {{NODE_VERSION}}
+          run-tests: "true"