Skip to content

Commit 51852c6

Browse files
ProfRandom92ProfRandom92
committed
Add local skill bundle registry (Phase 13)
1 parent cb05168 commit 51852c6

13 files changed

Lines changed: 401 additions & 9 deletions

File tree

‎.agent/skills/REGISTRY.md‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# Local Skill Bundle Registry
2+
3+
This document serves as the local registry index for all authorized skills in the CompText workspace.
4+
5+
> [!IMPORTANT]
6+
> - **Local Scope**: This registry operates strictly as a local repository index. It is **not** a remote, distributed, or cloud-based plugin marketplace.
7+
> - **Integrity Hashes**: The SHA-256 checksums recorded below are strictly for local change-detection and workspace configuration verification. They do **not** represent cryptographic security proofs or remote package validation.
8+
9+
---
10+
11+
## Skill Index
12+
13+
### 1. `ctxt-antigravity-governance`
14+
- **Path**: [.agent/skills/ctxt-antigravity-governance/SKILL.md](file:///.agent/skills/ctxt-antigravity-governance/SKILL.md)
15+
- **Description**: Defines token-efficient governance and operating guidelines for agent runs.
16+
- **Intended Use**: Auditing agent runs, defining permissions baseline, and selecting model effort.
17+
- **Allowed Scope**: Reading `AGENTS.md`, `PROJEKT.md`, token docs.
18+
- **Forbidden Scope**: Reading `.env`, printing env, live network/provider calls, out-of-bounds writes.
19+
- **Validation Commands**: `cargo test`, `git diff --exit-code`
20+
- **Local SHA-256 Checksum**: `3BD2A34E74EF24DA0EE871691AFF7528B655D738C3687EBAAA41D8A10CA575EB`
21+
22+
### 2. `ctxt-security-review`
23+
- **Path**: [.agent/skills/ctxt-security-review/SKILL.md](file:///.agent/skills/ctxt-security-review/SKILL.md)
24+
- **Description**: Audits repository modifications against safety boundaries, credential safety, and claims hygiene.
25+
- **Intended Use**: Running security audits on code changes and checking documentation claims before commits.
26+
- **Allowed Scope**: Scanning repository workspace, adjusting `.gitignore` rules, verifying offline providers.
27+
- **Forbidden Scope**: Reading `.env`, printing env, live network/provider calls, out-of-bounds writes.
28+
- **Validation Commands**: `cargo test`
29+
- **Local SHA-256 Checksum**: `5C2E7E9167EF2532B06212307DD4D7CADAC31509D8855332269FDEF2158DD367`
30+
31+
### 3. `ctxt-ci-diagnoser`
32+
- **Path**: [.agent/skills/ctxt-ci-diagnoser/SKILL.md](file:///.agent/skills/ctxt-ci-diagnoser/SKILL.md)
33+
- **Description**: Analyzes Cargo compilation failures, clippy warnings, or test logs to suggest precise repairs.
34+
- **Intended Use**: Locating and fixing local Cargo build errors, Clippy lint issues, or failing unit/smoke tests.
35+
- **Allowed Scope**: Modifying Rust source files (`src/**`) and test files (`tests/**`) to fix compilation or lint bugs.
36+
- **Forbidden Scope**: Suppressing compiler errors, adding new dependencies, live network requests.
37+
- **Validation Commands**: `cargo check`, `cargo test`, `cargo clippy -- -D warnings`
38+
- **Local SHA-256 Checksum**: `157A487EF1A349F25A3D37AA73EF52CC0EC3D59375073886673D6AAA8D479E6D`
39+
40+
### 4. `ctxt-docs-consistency-checker`
41+
- **Path**: [.agent/skills/ctxt-docs-consistency-checker/SKILL.md](file:///.agent/skills/ctxt-docs-consistency-checker/SKILL.md)
42+
- **Description**: Audits markdown documentation for broken links, file presence, and claims hygiene.
43+
- **Intended Use**: Verification of markdown integrity, readme references, and documentation locations.
44+
- **Allowed Scope**: Modifying markdown documents in `docs/`, `reports/`, and repository root.
45+
- **Forbidden Scope**: Creating/modifying Rust code, adding forbidden readiness/compatibility claims.
46+
- **Validation Commands**: `git status --porcelain`
47+
- **Local SHA-256 Checksum**: `C1C7F9751F77F7EB00A103C10468A947CB603E342FC6E00166B6A0B96707ED7B`
48+
49+
### 5. `ctxt-proposal-auditor`
50+
- **Path**: [.agent/skills/ctxt-proposal-auditor/SKILL.md](file:///.agent/skills/ctxt-proposal-auditor/SKILL.md)
51+
- **Description**: Reviews proposal JSON files to verify schema shapes and target write path safety.
52+
- **Intended Use**: Reviewing proposal JSON files under `proposals/` before executing apply operations.
53+
- **Allowed Scope**: Reading proposal files under `proposals/` and checking write allowed boundaries.
54+
- **Forbidden Scope**: Executing manual patch applications outside of the `ctxt apply` command.
55+
- **Validation Commands**: `cargo run --bin ctxt -- validate`
56+
- **Local SHA-256 Checksum**: `9879D22861B7F4A5438BAF3BBA45C65888F7F42A618C1B6E76AE1A9626246FBF`
57+
58+
### 6. `ctxt-release-packaging`
59+
- **Path**: [.agent/skills/ctxt-release-packaging/SKILL.md](file:///.agent/skills/ctxt-release-packaging/SKILL.md)
60+
- **Description**: Audits release checklist, compiles release target binary, and verifies git hygiene.
61+
- **Intended Use**: Checking release readiness checklists, writing release tags, compiling release build binary.
62+
- **Allowed Scope**: Compiling release build (`cargo build --release`), updating version tags, editing changelogs.
63+
- **Forbidden Scope**: Committing temporary `.comptext/` cache directories, force pushes.
64+
- **Validation Commands**: `cargo build --release`, `git diff --exit-code`
65+
- **Local SHA-256 Checksum**: `099603E467A7E2EDD7DE82FCE3A453377F980FD8423FFF7FF3CB96164521BE82`
66+
67+
### 7. `ctxt-phase-13-skill-bundle-registry`
68+
- **Path**: [.agent/skills/ctxt-phase-13-skill-bundle-registry/SKILL.md](file:///.agent/skills/ctxt-phase-13-skill-bundle-registry/SKILL.md)
69+
- **Description**: Manages the local Skill Bundle Registry files, templates, and integrity check metadata.
70+
- **Intended Use**: Registering skill capsules, normalizing directory structures, and updating change-detection hashes.
71+
- **Allowed Scope**: Staging and editing `.agent/skills/REGISTRY.md` or `.agent/skills/registry.json`.
72+
- **Forbidden Scope**: Implementing remote network registries, distributed downloads, or cryptographic proof logic.
73+
- **Validation Commands**: `cargo test`, `git status`
74+
- **Local SHA-256 Checksum**: `7B2F81C2AF5A97B2E0FA8A1243FABA9F605985A2F35E675F4C429DDBAE426B21`

‎.agent/skills/ctxt-antigravity-governance/SKILL.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,10 @@ Enforce token-efficient context parsing, hook governance, permissions checks, an
2121
- Defining permissions profiles or subagent boundaries.
2222
- Refining token usage and model effort guidelines.
2323

24+
## Allowed
25+
- Reading and verifying configuration and markdown governance documentation.
26+
- Reviewing token economics and model effort selections.
27+
2428
## Forbidden
2529
- Reading `.env` or credentials files.
2630
- Dumping environment variables.

‎.agent/skills/ctxt-ci-diagnoser/SKILL.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
name: ctxt-ci-diagnoser
3+
description: "Analyzes Cargo compilation failures, clippy warnings, or test logs to suggest precise repairs."
4+
summary: "Analyzes Cargo compilation failures, clippy warnings, or test logs to suggest precise repairs."
5+
---
6+
7+
# Skill: ctxt-ci-diagnoser
8+
9+
## Goal
10+
Diagnose and repair Cargo compilation errors, clippy warnings, or test suite failures in the local workspace.
11+
12+
## Read first
13+
- PROJEKT.md
14+
- Cargo.toml
15+
16+
## Use when
17+
- Local `cargo check`, `cargo build`, or `cargo test` commands fail.
18+
- Clippy output contains warnings.
19+
- The CI clean tree check fails.
20+
21+
## Allowed
22+
- Modifying Rust source files (`src/**`) and test files (`tests/**`) to fix lint, compiler, or test bugs.
23+
- Running compilation and lint verification suites in the local workspace.
24+
25+
## Forbidden
26+
- Bypassing compiler warnings or suppressing clippy errors without resolving them.
27+
- Adding new Rust dependencies without prior approval.
28+
- Performing live network requests to fetch external crates during diagnosing.
29+
30+
## Validation
31+
- `cargo check`
32+
- `cargo test`
33+
- `cargo clippy -- -D warnings`
34+
35+
## Return
36+
Standard Phase Return Format.

‎.agent/skills/ctxt-docs-consistency-checker/SKILL.md‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
name: ctxt-docs-consistency-checker
3+
description: "Audits markdown documentation for broken links, file presence, and claims hygiene."
4+
summary: "Audits markdown documentation for broken links, file presence, and claims hygiene."
5+
---
6+
7+
# Skill: ctxt-docs-consistency-checker
8+
9+
## Goal
10+
Verify formatting, markdown link integrity, document locations, and claims hygiene across all workspace documentation.
11+
12+
## Read first
13+
- README.md
14+
- docs/ROADMAP.md
15+
16+
## Use when
17+
- Creating or updating files in `docs/` or `reports/`.
18+
- Auditing navigation links in the README.
19+
- Validating that no forbidden readiness or compatibility claims exist.
20+
21+
## Allowed
22+
- Modifying markdown files in `docs/`, `reports/`, and the root directory.
23+
- Relocating misplaced phase status reports to correct folders.
24+
25+
## Forbidden
26+
- Adding claims regarding production readiness, enterprise certification, or guaranteed safety.
27+
- Creating or editing Rust source code.
28+
- Performing live network connections.
29+
30+
## Validation
31+
- `git status --porcelain`
32+
33+
## Return
34+
Standard Phase Return Format.

‎.agent/skills/ctxt-phase-13-skill-bundle-registry/SKILL.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
name: ctxt-phase-13-skill-bundle-registry
3+
description: "Manages the local Skill Bundle Registry files, templates, and integrity check metadata."
4+
summary: "Manages the local Skill Bundle Registry files, templates, and integrity check metadata."
5+
---
6+
7+
# Skill: ctxt-phase-13-skill-bundle-registry
8+
9+
## Goal
10+
Manage the local Skill Bundle Registry, maintain the index, and verify skill integrity hashes for local change detection.
11+
12+
## Read first
13+
- docs/SKILL_BUNDLE_REGISTRY.md
14+
- docs/SKILL_AUTHORING_GUIDE.md
15+
16+
## Use when
17+
- Normalizing folder structures under `.agent/skills/`.
18+
- Regenerating registry lists or computing file integrity checksums.
19+
- Adding starter skill templates to the local repository.
20+
21+
## Allowed
22+
- Staging and editing `.agent/skills/REGISTRY.md` or `.agent/skills/registry.json`.
23+
- Calculating local checksums for tracking changes.
24+
25+
## Forbidden
26+
- Implementing distributed registry networking or remote downloads.
27+
- Adding cryptographic provenance or security proofs to hashes.
28+
- Mutating core Rust logic.
29+
30+
## Validation
31+
- `cargo test`
32+
- `git status`
33+
34+
## Return
35+
Standard Phase Return Format.

‎.agent/skills/ctxt-proposal-auditor/SKILL.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
name: ctxt-proposal-auditor
3+
description: "Reviews proposal JSON files to verify schema shapes and target write path safety."
4+
summary: "Reviews proposal JSON files to verify schema shapes and target write path safety."
5+
---
6+
7+
# Skill: ctxt-proposal-auditor
8+
9+
## Goal
10+
Audit the structure of generated JSON proposals and verify that target paths comply with apply-gate write boundaries.
11+
12+
## Read first
13+
- docs/APPLY_GATE.md
14+
- docs/ARTIFACT_POLICY.md
15+
16+
## Use when
17+
- Reviewing a proposal JSON file before executing `ctxt apply`.
18+
- Verifying the list of affected files in the proposal schema.
19+
- Confirming rollback strategy viability.
20+
21+
## Allowed
22+
- Reading and verifying proposal files under `proposals/`.
23+
- Checking that target apply paths lie entirely inside allowed write boundaries.
24+
25+
## Forbidden
26+
- Applying patch changes manually to source code outside the `ctxt apply` flow.
27+
- Modifying target file permissions.
28+
29+
## Validation
30+
- `cargo run --bin ctxt -- validate`
31+
32+
## Return
33+
Standard Phase Return Format.

‎.agent/skills/ctxt-release-packaging/SKILL.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
name: ctxt-release-packaging
3+
description: "Audits release checklist, compiles release target binary, and verifies git hygiene."
4+
summary: "Audits release checklist, compiles release target binary, and verifies git hygiene."
5+
---
6+
7+
# Skill: ctxt-release-packaging
8+
9+
## Goal
10+
Verify the release checklist, edit the changelog, build the production release binary, and ensure Git tree cleanliness.
11+
12+
## Read first
13+
- docs/RELEASE_CHECKLIST.md
14+
- CHANGELOG.md
15+
16+
## Use when
17+
- Compiling a stable local release package of the CLI.
18+
- Updating release tags and metadata.
19+
- Validating Git ignore rules before final release commits.
20+
21+
## Allowed
22+
- Compiling the target binary with release optimization (`cargo build --release`).
23+
- Modifying version metadata in `Cargo.toml`.
24+
- Writing release checklists and changelogs.
25+
26+
## Forbidden
27+
- Committing temporary `.comptext/` cache directories.
28+
- Rewriting Git history or performing force pushes.
29+
- Adding unverified or uncompiled files to the release package.
30+
31+
## Validation
32+
- `cargo build --release`
33+
- `git diff --exit-code`
34+
35+
## Return
36+
Standard Phase Return Format.

‎.agent/skills/ctxt-security-review/SKILL.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
name: ctxt-security-review
3+
description: "Audits repository modifications against safety boundaries, credential safety, and claims hygiene."
4+
summary: "Audits repository modifications against safety boundaries, credential safety, and claims hygiene."
5+
---
6+
7+
# Skill: ctxt-security-review
8+
9+
## Goal
10+
Audit codebase safety, confirm secret redaction, and ensure no forbidden readiness or compliance claims exist in repository files.
11+
12+
## Read first
13+
- AGENTS.md
14+
- docs/SECURITY_MODEL.md
15+
16+
## Use when
17+
- Performing security checks before a git commit.
18+
- Inspecting files for high-entropy secrets or private keys.
19+
- Reviewing documentation for forbidden readiness or compliance claims.
20+
21+
## Allowed
22+
- Reading and scanning files within the repository workspace.
23+
- Adjusting `.gitignore` files to exclude runtime state.
24+
- Verifying offline status of providers.
25+
26+
## Forbidden
27+
- Reading `.env` or configuration files.
28+
- Printing environment variables.
29+
- Performing live network calls without explicit phase authorization.
30+
- Writing outside the repository root.
31+
32+
## Validation
33+
- `cargo test`
34+
35+
## Return
36+
Standard Phase Return Format.

‎PROJEKT.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,9 @@ CompText CLI is an experimental terminal context client for building determinist
1919

2020
### Current State
2121
```text
22-
CURRENT_PHASE: 12
23-
CURRENT_TASK: Antigravity CLI Governance & Token Economy
24-
LAST_GREEN_PHASE: 12
22+
CURRENT_PHASE: 13
23+
CURRENT_TASK: Skill Bundle Registry
24+
LAST_GREEN_PHASE: 13
2525
STATUS: complete
2626
```
2727

@@ -87,8 +87,8 @@ git push
8787
| **Phase 10** | MVP Stabilization & Release Readiness | Audit documentation, verify command flows, safety hygiene checks | **COMPLETE** |
8888
| **Phase 11** | Release Packaging | Package CLI binary, finalize manifests, release artifact generation | **COMPLETE** |
8989
| **Phase 12** | Antigravity CLI Governance & Token Economy | Antigravity governance docs, token economy rules, skill/hook/permission target architecture | **COMPLETE** |
90-
| **Phase 13** | Skill Bundle Registry | Distributed skills indexing and integrity hashing | *NEXT* |
91-
| **Phase 14** | Hook/Permission Integration | Hook boundaries, dynamic run approvals | *QUEUED* |
90+
| **Phase 13** | Skill Bundle Registry | Local skill bundle registry and starter skill templates | **COMPLETE** |
91+
| **Phase 14** | Hook/Permission Integration | Hook boundaries, dynamic run approvals | *NEXT* |
9292
| **Phase 15** | Cryptographic Provenance Engine | Signed evidence trail generation and cryptographic integrity seals | *QUEUED* |
9393

9494
---

‎README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,8 @@
2323
<a href="#why-comptext">Why CompText?</a> ·
2424
<a href="#artifacts">Artifacts</a> ·
2525
<a href="#contributing">Contributing</a> ·
26-
<a href="assets/README.md">Brand Assets</a>
26+
<a href="assets/README.md">Brand Assets</a> ·
27+
<a href="docs/SKILL_BUNDLE_REGISTRY.md">Skill Registry</a>
2728
</p>
2829

2930
CompText CLI (`ctxt`) is an experimental, local-first terminal tool for turning messy repository state into deterministic, reviewable Context Packs before talking to model providers.

0 commit comments

Comments
 (0)