skillsystem

package module
v0.0.0-...-7cce3c2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 14, 2026 License: Apache-2.0 Imports: 2 Imported by: 0

README

Helix Skills

Revision: 3 Last modified: 2026-07-18T01:15:00Z

Skills system for CLI AI Agents. Inherits the Helix Constitution as the constitution/ submodule — every universal rule from constitution/CLAUDE.md and constitution/Constitution.md applies unconditionally.

Package Inventory

Direct Git Submodules
Repo URL Path
HelixConstitution git@github.com:HelixDevelopment/HelixConstitution.git constitution/
Constitution Skills (7 installed via register.sh)
Skill Directory Complexity
action-prefix-system constitution/skills/action-prefix-system/ intermediate
media-validator constitution/skills/media-validator/ intermediate
multitrack constitution/skills/multitrack/ advanced
reporting-workable-items constitution/skills/reporting-workable-items/ intermediate
scheduled-work-queue constitution/skills/scheduled-work-queue/ intermediate
session-sync constitution/skills/session-sync/ advanced
workable-item-lifecycle constitution/skills/workable-item-lifecycle/ intermediate
Draft Skills (in INDEX.md, pending activation)
Skill Domain
android.overview android
java.language language
kotlin.language language
linux.os os
MCP Tool Servers (2)
Server Definition
media-validator constitution/mcp/media-validator-mcp.json
scheduled-work constitution/mcp/scheduled-work-mcp.json
Claude Code Plugins (2)
Plugin Source
helix constitution/plugins/helix/
scheduled-work constitution/plugins/scheduled-work/
Depth-1 Reusable Engines (4)
Engine Path Status
continuum constitution/submodules/continuum/ implemented
session_orchestrator constitution/submodules/session_orchestrator/ design
token_optimizer constitution/submodules/token_optimizer/ design
clickup_sync constitution/submodules/clickup_sync/ design (Phase 0)
Declared Dependencies (6)
Repo Org Required by
TOON vasic-digital token_optimizer
Embeddings vasic-digital token_optimizer
VectorDB vasic-digital token_optimizer
Normalize vasic-digital token_optimizer
LLMProvider HelixDevelopment token_optimizer
conversation vasic-digital token_optimizer

Documentation

Tracked-Items + Status Documents
Document Last modified Revision Markdown HTML PDF
Gaps & Risks Register 2026-07-17T22:00:00Z 9 md — —
CONTINUATION 2026-07-18T00:30:00Z 4 md — —
Skills Catalog — — md — —
Repo Detail Index — — md — —

Upstream Mirrors

Host URL
GitHub (HelixDevelopment) git@github.com:HelixDevelopment/helix_skills.git
GitLab (helixdevelopment1) git@gitlab.com:helixdevelopment1/helix_skills.git
GitFlic git@gitflic.ru:helixdevelopment/helix_skills.git
GitVerse git@gitverse.ru:helixdevelopment/helix_skills.git

Quick Start

# Clone with submodules
git clone --recurse-submodules git@github.com:HelixDevelopment/helix_skills.git
cd helix_skills

# Install upstreams (§11.4.36)
install_upstreams

# Register constitution skills
for s in constitution/skills/*/register.sh; do bash "$s"; done

Documentation

Overview

Package skillsystem is the module-root package. Its sole purpose is to embed the SQL schema-migration files into the compiled binary so cmd/server applies them deterministically, independent of the process working directory (§G23 / research/ops_hardening_design.md).

WHY THIS FILE LIVES AT THE MODULE ROOT (go:embed placement, §11.4.6). A //go:embed directive may only reference files at or below the directory of the Go source file that carries it, and the pattern may not contain ".." path elements. The migrations live at <module root>/migrations/*.sql. Neither internal/db nor cmd/server can reach them (`//go:embed ../../migrations/*.sql` is rejected by the compiler), so the embed MUST live in a package rooted at the module root — this file. The design's DECISION names the directive literally as `//go:embed migrations/*.sql`, which resolves only from here.

Index

Constants

This section is empty.

Variables

View Source 
var MigrationsFS fs.FS = mustSub(migrationFiles, "migrations")

MigrationsFS is the embedded migrations directory, re-rooted at "migrations" so its entries are the bare NNN_description.{up,down}.sql filenames — exactly the shape os.DirFS(dir) yields for the on-disk directory. That equivalence is what lets db.MigrateFS treat an embedded FS and an on-disk directory identically (fs.ReadDir(".") + fs.ReadFile(<base name>)).

Functions

This section is empty.

Types

This section is empty.

Source Files

View all Source files

Directories

Path Synopsis
cmd
cli command
cli/commands
Package commands implements the Cobra CLI commands for the skill-system.
 Package commands implements the Cobra CLI commands for the skill-system.
server command
cmd/server is the main entry point for the HelixKnowledge Skill System API and MCP server.
 cmd/server is the main entry point for the HelixKnowledge Skill System API and MCP server.
tui command
worker command
cmd/worker is the background worker process for the HelixKnowledge Skill Graph System.
 cmd/worker is the background worker process for the HelixKnowledge Skill Graph System.
internal
api
Package api provides the HTTP API layer for the HelixKnowledge Skill Graph System.
 Package api provides the HTTP API layer for the HelixKnowledge Skill Graph System.
autoexpand
Package autoexpand provides LLM integration for skill drafting in the HelixKnowledge auto-growth pipeline.
 Package autoexpand provides LLM integration for skill drafting in the HelixKnowledge auto-growth pipeline.
cache
Package cache provides a Redis-backed caching layer for the HelixKnowledge skill graph system, with graceful degradation to a NoopCache when Redis is unavailable or not configured.
 Package cache provides a Redis-backed caching layer for the HelixKnowledge skill graph system, with graceful degradation to a NoopCache when Redis is unavailable or not configured.
codeanalysis
Package codeanalysis provides high-level code analysis capabilities for the HelixKnowledge system.
 Package codeanalysis provides high-level code analysis capabilities for the HelixKnowledge system.
codegraph
Package codegraph provides the CodeGraph MCP integration layer for the HelixKnowledge Skill Graph System.
 Package codegraph provides the CodeGraph MCP integration layer for the HelixKnowledge Skill Graph System.
config
Package config provides configuration loading from TOML files with environment variable overrides.
 Package config provides configuration loading from TOML files with environment variable overrides.
db
Read/write pool separation for the HelixKnowledge skill graph system.
 Read/write pool separation for the HelixKnowledge skill graph system.
ingest/pipeline
Package pipeline implements the deterministic, LLM-free EXTRACT -> NORMALIZE -> map-to-models.Skill core of the ingestion pipeline (docs/research/.../DESIGN.md §2, stages 1-2, plus the "map to models.Skill" half of stage 6 CREATE).
 Package pipeline implements the deterministic, LLM-free EXTRACT -> NORMALIZE -> map-to-models.Skill core of the ingestion pipeline (docs/research/.../DESIGN.md §2, stages 1-2, plus the "map to models.Skill" half of stage 6 CREATE).
ingest/source
Package source defines the addressable-origin abstraction the skill ingestion pipeline pulls raw content from (F1.1 in docs/research/.../skill_ingestion_research/TRACKED_ITEMS.md; the design is docs/research/.../DESIGN.md §1).
 Package source defines the addressable-origin abstraction the skill ingestion pipeline pulls raw content from (F1.1 in docs/research/.../skill_ingestion_research/TRACKED_ITEMS.md; the design is docs/research/.../DESIGN.md §1).
mcp
Package mcp implements the Model Context Protocol server for the HelixKnowledge Skill Graph System.
 Package mcp implements the Model Context Protocol server for the HelixKnowledge Skill Graph System.
metrics
Package metrics provides Prometheus instrumentation for the HelixKnowledge skill graph system.
 Package metrics provides Prometheus instrumentation for the HelixKnowledge skill graph system.
models
registry
Package registry provides skill registry management and health monitoring for the HelixKnowledge system.
 Package registry provides skill registry management and health monitoring for the HelixKnowledge system.
skill
Package skill provides CRUD and search operations for skills in the knowledge graph.
 Package skill provides CRUD and search operations for skills in the knowledge graph.
skillscatalog
Package skillscatalog generates a deterministic, byte-stable Markdown reference catalog for the live skill graph (a top-level README + INDEX, by-domain and by-kind grouping pages, and one detail page per skill), together with a sha256 roster fingerprint sidecar (§11.4.86) that a later layer (CLI/REST/MCP/worker/git-hook -- G126+, explicitly OUT of this package's scope) can use to detect drift and re-arm regeneration.
 Package skillscatalog generates a deterministic, byte-stable Markdown reference catalog for the live skill graph (a top-level README + INDEX, by-domain and by-kind grouping pages, and one detail page per skill), together with a sha256 roster fingerprint sidecar (§11.4.86) that a later layer (CLI/REST/MCP/worker/git-hook -- G126+, explicitly OUT of this package's scope) can use to detect drift and re-arm regeneration.
skillsource
Package skillsource provides CRUD and sync-status management for registered skill sources — GitHub repos, filesystem paths, and URLs that supply SKILL.md files for the source-ingestion pipeline (internal/source/github, internal/source/mapper, internal/source/skillmd).
 Package skillsource provides CRUD and sync-status management for registered skill sources — GitHub repos, filesystem paths, and URLs that supply SKILL.md files for the source-ingestion pipeline (internal/source/github, internal/source/mapper, internal/source/skillmd).
source/dedup
Package dedup provides a classifier that determines whether a parsed skill is NEW (no match found), DUPLICATE (exact name match), or VARIANT (normalized name match with different content).
 Package dedup provides a classifier that determines whether a parsed skill is NEW (no match found), DUPLICATE (exact name match), or VARIANT (normalized name match with different content).
source/github
Package github provides a minimal, hand-rolled REST client for the GitHub API, used by the skill-source ingestion pipeline (see docs/source_ingestion/WIRING_PLAN.md §3.1/§1.9 for the design this file implements) to fetch a repository's file tree, head commit SHA, and individual file contents.
 Package github provides a minimal, hand-rolled REST client for the GitHub API, used by the skill-source ingestion pipeline (see docs/source_ingestion/WIRING_PLAN.md §3.1/§1.9 for the design this file implements) to fetch a repository's file tree, head commit SHA, and individual file contents.
source/mapper
Package mapper turns a parsed SKILL.md (internal/source/skillmd) into an in-memory models.Skill value, applying the namespacing and license-gate rules the GitHub-skills-ingestion feature requires (see docs/source_ingestion/WIRING_PLAN.md §3.4 / docs/source_ingestion/TRACKED_ITEMS.md G61 for the design this implements).
 Package mapper turns a parsed SKILL.md (internal/source/skillmd) into an in-memory models.Skill value, applying the namespacing and license-gate rules the GitHub-skills-ingestion feature requires (see docs/source_ingestion/WIRING_PLAN.md §3.4 / docs/source_ingestion/TRACKED_ITEMS.md G61 for the design this implements).
source/skillmd
Package skillmd parses SKILL.md files — the YAML-frontmatter-plus- markdown-body format Claude Code and the broader open agent-skills ecosystem use to define a skill (see docs/source_ingestion/CATALOG.md §2 for the authoritative field table this parser implements, verified against code.claude.com/docs/en/skills 2026-07-16).
 Package skillmd parses SKILL.md files — the YAML-frontmatter-plus- markdown-body format Claude Code and the broader open agent-skills ecosystem use to define a skill (see docs/source_ingestion/CATALOG.md §2 for the authoritative field table this parser implements, verified against code.claude.com/docs/en/skills 2026-07-16).
toon
Package toon is the HelixKnowledge Skill Graph System's adapter for the Token-Oriented Object Notation (TOON) wire format (register gap G08).
 Package toon is the HelixKnowledge Skill Graph System's adapter for the Token-Oriented Object Notation (TOON) wire format (register gap G08).
validation
Package validation implements the fail-closed, NON-EXECUTING skill validation pipeline for the HelixKnowledge system (the "zero-bluff guarantee").
 Package validation implements the fail-closed, NON-EXECUTING skill validation pipeline for the HelixKnowledge system (the "zero-bluff guarantee").
worker
Package worker provides background job execution for the HelixKnowledge skill graph system.
 Package worker provides background job execution for the HelixKnowledge skill graph system.
pkg
skills
Package skills is the pure-data skill loader (HXC-159 T-P4.01).
 Package skills is the pure-data skill loader (HXC-159 T-P4.01).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.