@hagicode/skillsbase 0.1.0-dev.11.1.4f10d19

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@hagicode/skillsbase",
+  "version": "0.1.0-dev.11.1.4f10d19",
+  "description": "Managed skills repository CLI",
+  "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-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,20 @@
+<!-- Managed by skillsbase CLI. -->
+
+# Maintainer Workflow
+
+The maintainer flow is `init -> add -> sync -> github_action`.
+
+## Lifecycle
+
+1. `skillsbase init`
+2. `skillsbase add <skill-name>`
+3. `skillsbase sync`
+4. `skillsbase github_action --kind all`
+
+## 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.

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-sync.yml

@@ -0,0 +1,45 @@
+# 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: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: {{NODE_VERSION}}
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Upgrade npm
+        run: npm install --global npm@10.9.2
+
+      - name: Install skillsbase
+        run: npm install --global @hagicode/skillsbase
+
+      - name: Run tests
+        run: npm test
+
+      - name: Validate managed repository state
+        run: skillsbase sync --check --repo .