agent-skillboard 0.1.0

package/examples/multi-source-skills/omo/review-work/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: omo.review-work
+description: Review completed implementation work with strict verification.
+---
+
+# OMO Review Work
+
+Harness-owned post-implementation review skill.

package/examples/multi-source-skills/omo/ulw-plan/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: omo.ulw-plan
+description: Plan complex work in a LazyCodex harness.
+---
+
+# OMO ULW Plan
+
+Harness-owned planning skill.

package/examples/multi-source-skills/private/tdd-work-continuity/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: private.tdd-work-continuity
+description: Keep local TDD work resumable with plan and verification notes.
+---
+
+# Private TDD Work Continuity
+
+Maintain continuity for project-specific engineering workflows.

package/examples/multi-source-skills/private/workflow-router/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: private.workflow-router
+description: Route incoming work to the correct workflow before exposing specialized skills.
+---
+
+# Private Workflow Router
+
+Keep global routing small and explicit.

package/examples/multi-source-skills/wshobson/python-testing/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: wshobson.python-testing
+description: Python testing workflow skill.
+---
+
+# Wshobson Python Testing
+
+Marketplace skill for Python test workflows.

package/examples/multi-source-skills/wshobson/security-review/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: wshobson.security-review
+description: Security review workflow skill.
+---
+
+# Wshobson Security Review
+
+Marketplace skill for security review workflows.

package/examples/multi-source.config.yaml

@@ -0,0 +1,271 @@
+version: 1
+defaults:
+  invocation_policy: deny-by-default
+  allow_model_invocation: false
+  require_explicit_workflow: true
+
+skills:
+  private.workflow-router:
+    path: private/workflow-router
+    status: active
+    invocation: router-only
+    exposure: global-meta
+    category: meta
+    owner_install_unit: local.agent-skills-private
+
+  private.tdd-work-continuity:
+    path: private/tdd-work-continuity
+    status: active
+    invocation: router-only
+    exposure: exported
+    category: engineering
+    owner_install_unit: local.agent-skills-private
+
+  matt.grill-me:
+    path: matt/grill-me
+    status: vendor
+    invocation: manual-only
+    exposure: exported
+    category: requirements
+    owner_install_unit: github.mattpocock.skills
+    replaced_by: private.workflow-router
+
+  matt.tdd:
+    path: matt/tdd
+    status: active
+    invocation: workflow-auto
+    exposure: exported
+    category: engineering
+    owner_install_unit: github.mattpocock.skills
+
+  omo.ulw-plan:
+    path: omo/ulw-plan
+    status: vendor
+    invocation: manual-only
+    exposure: unit-managed
+    category: handoff
+    owner_install_unit: github.code-yeongyu.oh-my-openagent
+
+  omo.review-work:
+    path: omo/review-work
+    status: vendor
+    invocation: manual-only
+    exposure: unit-managed
+    category: review
+    owner_install_unit: github.code-yeongyu.oh-my-openagent
+
+  anthropic.docx:
+    path: anthropic/docx
+    status: vendor
+    invocation: manual-only
+    exposure: exported
+    category: documents
+    owner_install_unit: github.anthropics.skills
+
+  anthropic.skill-creator:
+    path: anthropic/skill-creator
+    status: vendor
+    invocation: manual-only
+    exposure: exported
+    category: meta
+    owner_install_unit: github.anthropics.skills
+
+  wshobson.python-testing:
+    path: wshobson/python-testing
+    status: candidate
+    invocation: router-only
+    exposure: exported
+    category: engineering
+    owner_install_unit: github.wshobson.agents
+
+  wshobson.security-review:
+    path: wshobson/security-review
+    status: candidate
+    invocation: router-only
+    exposure: exported
+    category: security
+    owner_install_unit: github.wshobson.agents
+
+capabilities:
+  workflow-routing:
+    canonical: private.workflow-router
+    alternatives: []
+    default_policy: router-only
+
+  test-first-implementation:
+    canonical: matt.tdd
+    alternatives:
+      - private.tdd-work-continuity
+      - wshobson.python-testing
+    default_policy: workflow-auto
+
+  implementation-review:
+    canonical: omo.review-work
+    alternatives:
+      - wshobson.security-review
+    default_policy: router-only
+
+harnesses:
+  codex:
+    status: primary
+    workflows:
+      - codex-night-workflow
+      - skill-discovery-workflow
+
+  lazycodex:
+    status: fallback
+    workflows:
+      - large-refactor-workflow
+    commands:
+      - $ulw-plan
+      - $start-work
+
+  claude-code:
+    status: configured
+    workflows:
+      - document-workflow
+
+workflows:
+  codex-night-workflow:
+    harness: codex
+    active_skills:
+      - matt.tdd
+      - private.tdd-work-continuity
+    blocked_skills:
+      - matt.grill-me
+    required_capabilities:
+      test-first-implementation:
+        preferred: matt.tdd
+        fallback:
+          - private.tdd-work-continuity
+        policy: workflow-auto
+
+  large-refactor-workflow:
+    harness: lazycodex
+    active_skills:
+      - omo.ulw-plan
+      - omo.review-work
+      - wshobson.security-review
+    required_capabilities:
+      implementation-review:
+        preferred: omo.review-work
+        fallback:
+          - wshobson.security-review
+        policy: router-only
+
+  document-workflow:
+    harness: claude-code
+    active_skills:
+      - anthropic.docx
+
+  skill-discovery-workflow:
+    harness: codex
+    active_skills:
+      - private.workflow-router
+
+install_units:
+  local.agent-skills-private:
+    kind: skill
+    source: ./examples/multi-source-skills/private
+    scope: user-global
+    provided_components:
+      - skills
+    components:
+      skills:
+        - private.workflow-router
+        - private.tdd-work-continuity
+    enabled: true
+    trust_level: trusted
+    permission_risk: low
+    rollback: git
+
+  github.mattpocock.skills:
+    kind: marketplace
+    source: npx skills@latest add mattpocock/skills
+    scope: user-global
+    provided_components:
+      - skills
+    components:
+      skills:
+        - matt.grill-me
+        - matt.tdd
+    enabled: true
+    trust_level: reviewed
+    permission_risk: medium
+    rollback: reinstall
+
+  github.code-yeongyu.oh-my-openagent:
+    kind: harness
+    source: npx lazycodex-ai install
+    scope: user-global
+    provided_components:
+      - skills
+      - commands
+      - hooks
+      - mcp-server
+    components:
+      skills:
+        - omo.ulw-plan
+        - omo.review-work
+      commands:
+        - $ulw-plan
+        - $start-work
+      hooks:
+        - post-tool-use
+      mcp_servers:
+        - omo-docs
+    modified_config_files:
+      - ~/.codex/config.toml
+    enabled: true
+    trust_level: reviewed
+    workflow_dependencies:
+      - large-refactor-workflow
+    permission_risk: high
+    rollback: manual
+
+  github.anthropics.skills:
+    kind: marketplace
+    source: /plugin marketplace add anthropics/skills
+    scope: project
+    provided_components:
+      - skills
+    components:
+      skills:
+        - anthropic.docx
+        - anthropic.skill-creator
+    enabled: true
+    trust_level: reviewed
+    permission_risk: medium
+    rollback: plugin uninstall
+
+  github.wshobson.agents:
+    kind: marketplace
+    source: npx codex-marketplace add wshobson/agents
+    scope: project
+    provided_components:
+      - skills
+      - agents
+      - commands
+    components:
+      skills:
+        - wshobson.python-testing
+        - wshobson.security-review
+      commands:
+        - /plugin install python-development
+    enabled: true
+    trust_level: reviewed
+    permission_risk: medium
+    rollback: plugin uninstall
+
+  github.voltagent.awesome-agent-skills:
+    kind: marketplace
+    source: git clone https://github.com/VoltAgent/awesome-agent-skills
+    scope: cache
+    provided_components:
+      - marketplace
+    enabled: true
+    trust_level: unreviewed
+    workflow_dependencies:
+      - skill-discovery-workflow
+    permission_risk: low
+    rollback: remove cache

package/examples/skillboard.config.yaml

@@ -0,0 +1,194 @@
+version: 1
+
+defaults:
+  invocation_policy: deny-by-default
+  allow_model_invocation: false
+  require_explicit_workflow: true
+
+skills:
+  meerkat.requirement-intake:
+    path: requirement-intake
+    status: active
+    invocation: router-only
+    exposure: exported
+    category: requirements
+    canonical_for:
+      - requirement-clarification
+    conflicts_with:
+      - matt.grill-me
+
+  matt.tdd:
+    path: tdd
+    status: active
+    invocation: workflow-auto
+    exposure: exported
+    category: engineering
+
+  matt.grill-me:
+    path: grill-me
+    status: vendor
+    invocation: manual-only
+    exposure: exported
+    category: requirements
+    replaced_by: meerkat.requirement-intake
+
+  matt.grill-with-docs:
+    path: grill-with-docs
+    status: quarantined
+    invocation: blocked
+    exposure: exported
+    category: requirements
+    replaced_by: meerkat.requirement-intake
+
+  meerkat.test-first-implementation:
+    path: vendor/meerkat-test-first-implementation
+    status: candidate
+    invocation: workflow-auto
+    exposure: exported
+    category: engineering
+
+  meerkat.codex-ready-task:
+    path: vendor/meerkat-codex-ready-task
+    status: candidate
+    invocation: router-only
+    exposure: exported
+    category: handoff
+
+  lazycodex.ulw-plan:
+    path: vendor/lazycodex-ulw-plan
+    status: vendor
+    invocation: manual-only
+    exposure: unit-managed
+    category: handoff
+    owner_install_unit: lazycodex.omo
+
+  user.workflow-router:
+    path: user/workflow-router
+    status: active
+    invocation: global-auto
+    exposure: global-meta
+    category: meta
+
+capabilities:
+  requirement-clarification:
+    canonical: meerkat.requirement-intake
+    alternatives:
+      - matt.grill-me
+      - matt.grill-with-docs
+    default_policy: router-only
+
+  test-first-implementation:
+    canonical: matt.tdd
+    alternatives:
+      - meerkat.test-first-implementation
+    default_policy: workflow-auto
+
+  codex-handoff:
+    canonical: meerkat.codex-ready-task
+    alternatives:
+      - lazycodex.ulw-plan
+    default_policy: router-only
+
+harnesses:
+  codex:
+    status: primary
+    workflows:
+      - codex-night-workflow
+
+  claude:
+    status: configured
+    workflows:
+      - requirement-review
+
+  lazycodex:
+    status: fallback
+    workflows:
+      - large-refactor-workflow
+    commands:
+      - $ulw-plan
+      - $start-work
+      - $ulw-loop
+
+install_units:
+  lazycodex.omo:
+    kind: harness
+    source: npx lazycodex-ai install
+    scope: user-global
+    manifest_path: ~/.codex/plugins/cache/sisyphuslabs/omo/plugin.json
+    cache_path: ~/.codex/plugins/cache/sisyphuslabs/omo
+    provided_components:
+      - skills
+      - commands
+      - mcp-server
+      - hook
+    components:
+      skills:
+        - lazycodex.ulw-plan
+      commands:
+        - $ulw-plan
+        - $start-work
+        - $ulw-loop
+      hooks:
+        - post-tool-use
+      mcp_servers:
+        - omo-docs
+    modified_config_files:
+      - ~/.codex/config.toml
+      - ~/.codex/plugins/cache
+      - ~/.local/bin
+    auto_update: false
+    enabled: true
+    trust_level: reviewed
+    workflow_dependencies:
+      - large-refactor-workflow
+    permission_risk: high
+    rollback: manual
+
+workflows:
+  codex-night-workflow:
+    harness: codex
+    active_skills:
+      - meerkat.requirement-intake
+      - matt.tdd
+    blocked_skills:
+      - matt.grill-me
+    required_outputs:
+      - diff_summary
+      - test_result_or_reason
+      - risk_notes
+    required_capabilities:
+      test-first-implementation:
+        preferred: matt.tdd
+        fallback:
+          - meerkat.test-first-implementation
+        policy: workflow-auto
+
+  requirement-review:
+    harness: claude
+    active_skills:
+      - meerkat.requirement-intake
+    blocked_skills: []
+    required_outputs:
+      - clarified_requirements
+      - open_questions
+    required_capabilities:
+      requirement-clarification:
+        preferred: meerkat.requirement-intake
+        fallback:
+          - matt.grill-with-docs
+        policy: router-only
+
+  large-refactor-workflow:
+    harness: lazycodex
+    active_skills:
+      - lazycodex.ulw-plan
+    blocked_skills: []
+    required_outputs:
+      - migration_plan
+      - verification_summary
+    required_capabilities:
+      codex-handoff:
+        preferred: lazycodex.ulw-plan
+        fallback:
+          - meerkat.codex-ready-task
+        policy: manual-only

package/examples/skills/grill-me/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: grill-me
+description: Ask strict clarifying questions before work begins.
+---
+
+# Grill Me
+
+Vendor skill kept for manual comparison. It is blocked in the sample night
+workflow because `requirement-intake` is canonical.

package/examples/skills/grill-with-docs/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: matt.grill-with-docs
+description: Requirement clarification that also updates durable project docs.
+---
+
+# Grill With Docs
+
+Use only when a workflow explicitly allows requirements clarification that
+changes durable project documentation.

package/examples/skills/requirement-intake/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: requirement-intake
+description: Route vague feature requests into clear requirements, open questions, and implementation-ready scope.
+---
+
+# Requirement Intake
+
+Use when a task needs clarification before implementation. Produce a short
+decision brief, unresolved owner decisions, and a suggested workflow.

package/examples/skills/tdd/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: tdd
+description: Drive coding tasks through failing-first tests, implementation, and verification.
+---
+
+# TDD
+
+Use when implementation work needs a red-green verification loop.

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "agent-skillboard",
+  "version": "0.1.0",
+  "description": "Policy and visibility layer for AI agent skills.",
+  "keywords": [
+    "ai-agent",
+    "skills",
+    "codex",
+    "claude-code",
+    "policy"
+  ],
+  "homepage": "https://github.com/NyXXiR/skillboard#readme",
+  "bugs": {
+    "url": "https://github.com/NyXXiR/skillboard/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NyXXiR/skillboard.git"
+  },
+  "type": "module",
+  "files": [
+    "bin",
+    "src",
+    "docs",
+    "examples",
+    "profiles",
+    "README.md",
+    "CONTRIBUTING.md",
+    "LICENSE",
+    "tsconfig.lsp.json"
+  ],
+  "bin": {
+    "skillboard": "bin/skillboard.mjs",
+    "agent-skillboard": "bin/skillboard.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --test",
+    "test:unit": "node --test test/advisor-brief-actions.test.mjs test/advisor-brief.test.mjs test/ecosystem-docs.test.mjs test/install-units.test.mjs test/package.test.mjs test/policy.test.mjs test/skillboard.test.mjs",
+    "test:integration": "node --test test/brief-cli.test.mjs test/cli.test.mjs test/control-exports.test.mjs test/first-time-ux.test.mjs test/hook-dry-run.test.mjs test/hook-install-cli.test.mjs test/hook-json-errors.test.mjs test/install-units.test.mjs test/lifecycle-cli.test.mjs test/lifecycle-reset-cli.test.mjs test/multi-source-integration.test.mjs test/package.test.mjs test/policy-hardening.test.mjs test/review-cli.test.mjs test/source-profiles.test.mjs",
+    "diagnostics": "tsc -p tsconfig.lsp.json",
+    "check": "node --check bin/skillboard.mjs && npm run diagnostics && node --test"
+  },
+  "dependencies": {
+    "yaml": "^2.8.1"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "typescript": "^6.0.3",
+    "typescript-language-server": "^5.3.0"
+  }
+}

package/profiles/anthropics-skills.yaml

@@ -0,0 +1,17 @@
+id: github.anthropics.skills
+source: anthropics/skills
+kind: marketplace
+namespace: anthropic
+target_path_prefix: anthropic
+scope: project
+default_status: vendor
+default_invocation: manual-only
+default_exposure: exported
+default_category: uncategorized
+provided_components:
+  - skills
+skill_paths:
+  - "skills/**/SKILL.md"
+  - "*/SKILL.md"
+permission_risk: medium
+rollback: plugin uninstall

package/profiles/mattpocock-skills.yaml

@@ -0,0 +1,26 @@
+id: github.mattpocock.skills
+source: mattpocock/skills
+kind: marketplace
+namespace: matt
+target_path_prefix: matt
+scope: user-global
+default_status: vendor
+default_invocation: manual-only
+default_exposure: exported
+default_category: uncategorized
+category_path_segment: 1
+path_rules:
+  - pattern: "skills/deprecated/**/SKILL.md"
+    status: deprecated
+    invocation: deprecated
+    category: deprecated
+  - pattern: "skills/in-progress/**/SKILL.md"
+    status: candidate
+    category: in-progress
+provided_components:
+  - skills
+skill_paths:
+  - "skills/**/SKILL.md"
+  - "*/SKILL.md"
+permission_risk: medium
+rollback: reinstall

package/profiles/oh-my-openagent.yaml

@@ -0,0 +1,32 @@
+id: github.code-yeongyu.oh-my-openagent
+source: code-yeongyu/oh-my-openagent
+kind: harness
+namespace: omo
+target_path_prefix: omo
+scope: user-global
+default_status: vendor
+default_invocation: manual-only
+default_exposure: unit-managed
+default_category: uncategorized
+provided_components:
+  - skills
+  - commands
+  - hooks
+  - mcp-server
+skill_paths:
+  - "skills/**/SKILL.md"
+  - "plugins/*/skills/**/SKILL.md"
+components:
+  commands:
+    - $ulw-plan
+    - $start-work
+  hooks:
+    - post-tool-use
+  mcp_servers:
+    - omo-docs
+modified_config_files:
+  - ~/.codex/config.toml
+auto_update: false
+enabled: true
+permission_risk: high
+rollback: manual