Skip to content

Commit 193af94

Browse files
breadonceebreadoncee
committed
feat(skills): add activation hints to core skills
1 parent 17318e0 commit 193af94

12 files changed

Lines changed: 73 additions & 12 deletions

File tree

‎skills/create-doc/SKILL.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,14 @@ name: create-doc
33
description: Create a new doc file in .chalk/docs/ when the user asks to create, write, or add documentation
44
owner: chalk
55
version: "1.0.0"
6-
metadata-version: "1"
6+
metadata-version: "2"
77
allowed-tools: Read, Glob, Write
88
argument-hint: "[doc description]"
9+
capabilities: docs.create, chalk.docs.create
10+
activation-intents: create doc, add documentation, write documentation
11+
activation-events: user-prompt
12+
activation-artifacts: .chalk/docs/**
13+
risk-level: low
914
---
1015

1116
Create a new documentation file in `.chalk/docs/`.

‎skills/create-handoff/SKILL.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,14 @@ name: create-handoff
33
description: Generate a handoff document after implementation work is complete — summarizes changes, risks, and review focus areas for the review pipeline. Use when done coding and ready to hand off for review.
44
owner: chalk
55
version: "1.0.0"
6-
metadata-version: "1"
6+
metadata-version: "2"
77
allowed-tools: Bash, Read, Glob, Grep, Write
88
argument-hint: "[optional session name or issue reference]"
9+
capabilities: review.handoff.create, review.pipeline
10+
activation-intents: create handoff, write handoff, hand off changes
11+
activation-events: user-prompt
12+
activation-artifacts: .chalk/reviews/**
13+
risk-level: low
914
---
1015

1116
# Create Handoff

‎skills/create-plan/SKILL.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,14 @@ name: create-plan
33
description: Create a .plan.md file when the user asks to make a plan, create a plan, write a plan, or similar
44
owner: chalk
55
version: "1.0.0"
6-
metadata-version: "1"
6+
metadata-version: "2"
77
allowed-tools: Read, Glob, Write
88
argument-hint: "[plan description]"
9+
capabilities: planning.create, chalk.plans
10+
activation-intents: create plan, make a plan, plan this
11+
activation-events: user-prompt
12+
activation-artifacts: .chalk/.cursor/plans/**, AGENTS.md
13+
risk-level: low
914
---
1015

1116
Follow the plan creation conventions defined in `.chalk/.cursor/plans/` and any project `AGENTS.md` if present.

‎skills/create-review/SKILL.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,14 @@ name: create-review
33
description: Bootstrap a local AI review pipeline and generate a paste-ready review prompt for any reviewer agent. Use after creating a handoff or when ready to get an AI code review.
44
owner: chalk
55
version: "1.1.0"
6-
metadata-version: "1"
6+
metadata-version: "2"
77
allowed-tools: Bash, Read, Glob, Grep, Write
88
argument-hint: "[reviewer-name] e.g. codex, gemini, gpt4, claude — optional, used for labeling only"
9+
capabilities: review.bootstrap, review.prompt.create
10+
activation-intents: create review, start review, generate review prompt
11+
activation-events: user-prompt
12+
activation-artifacts: .chalk/reviews/**
13+
risk-level: medium
914
---
1015

1116
# Create Review

‎skills/fix-findings/SKILL.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,14 @@ name: fix-findings
33
description: Fix findings from the active review session — reads reviewer findings files, applies fixes by priority, and updates the resolution log. Use after pasting reviewer output into findings files.
44
owner: chalk
55
version: "1.0.0"
6-
metadata-version: "1"
6+
metadata-version: "2"
77
allowed-tools: Bash, Read, Edit, Grep, Glob, Write
88
argument-hint: "[reviewer-name|all] e.g. codex, gemini, gpt4, or omit for all"
9+
capabilities: review.findings.fix, review.resolution.update
10+
activation-intents: fix findings, address findings, resolve review findings
11+
activation-events: user-prompt, post-tool-use
12+
activation-artifacts: .chalk/reviews/**, **/*
13+
risk-level: high
914
---
1015

1116
# Fix Review Session Findings

‎skills/fix-review/SKILL.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,14 @@ name: fix-review
33
description: When the user asks to fix, address, or work on PR review comments — fetch review comments from a GitHub pull request and apply fixes to the local codebase. Requires gh CLI.
44
owner: chalk
55
version: "1.0.0"
6-
metadata-version: "1"
6+
metadata-version: "2"
77
allowed-tools: Bash, Read, Edit, Grep, Glob, Write
88
argument-hint: "[pr-number]"
9+
capabilities: github.review.fix, review.comments.apply
10+
activation-intents: fix review comments, address pr feedback, apply review fixes
11+
activation-events: user-prompt
12+
activation-artifacts: .github/**, **/*
13+
risk-level: high
914
---
1015

1116
# Fix PR Review Comments

‎skills/product-context-docs/SKILL.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,14 @@ name: product-context-docs
33
description: Create and update in-repo product context documentation in /docs (product profile, features, sitemap, architecture, tech stack). Use when asked to document a product, bootstrap /docs structure, or refresh product/tech context docs for a repo.
44
owner: chalk
55
version: "1.0.0"
6-
metadata-version: "1"
6+
metadata-version: "2"
77
allowed-tools: Read, Glob, Grep, Write, Edit
88
argument-hint: "[optional: product context doc request]"
9+
capabilities: product.docs.create, product.docs.update
10+
activation-intents: document product, bootstrap docs, refresh product context
11+
activation-events: user-prompt
12+
activation-artifacts: docs/**, README.md
13+
risk-level: low
914
---
1015

1116
# Product Context Docs

‎skills/project-skill-creator/SKILL.md‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,14 @@ name: project-skill-creator
33
description: Creates project-managed skills in .chalk/skills with safe naming, ownership metadata, and versioned frontmatter.
44
owner: chalk
55
version: "1.0.0"
6-
metadata-version: "1"
6+
metadata-version: "2"
77
allowed-tools: Read, Glob, Write
88
argument-hint: "[skill name, purpose, optional triggers/examples]"
9+
capabilities: skills.project.create, skills.scaffold
10+
activation-intents: create project skill, add local skill, scaffold skill
11+
activation-events: user-prompt
12+
activation-artifacts: .chalk/skills/**
13+
risk-level: medium
914
---
1015

1116
# Project Skill Creator
@@ -39,6 +44,7 @@ Create project-managed skills in `.chalk/skills` without conflicting with Chalk-
3944
description: <purpose/description>
4045
owner: project
4146
version: "1.0.0"
47+
metadata-version: "2"
4248
---
4349
```
4450

‎skills/review-changes/SKILL.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,14 @@ name: review-changes
33
description: End-to-end review pipeline — creates a handoff, generates a review (self-review or paste-ready for another provider), then offers to fix findings. Use when you want to review your changes before pushing.
44
owner: chalk
55
version: "1.0.0"
6-
metadata-version: "1"
6+
metadata-version: "2"
77
allowed-tools: Bash, Read, Edit, Grep, Glob, Write
88
argument-hint: "[optional session name or issue reference]"
9+
capabilities: review.orchestrate, review.pipeline
10+
activation-intents: review my changes, run review pipeline, self review changes
11+
activation-events: user-prompt, session-start
12+
activation-artifacts: .chalk/reviews/**, **/*
13+
risk-level: high
914
---
1015

1116
# Review Changes

‎skills/setup-chalk/SKILL.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,14 @@ name: setup-chalk
33
description: Initialize .chalk folder with style transfer — analyze a repo and capture its architecture, coding style, tech stack, design assets, and color palette into structured docs
44
owner: chalk
55
version: "1.0.0"
6-
metadata-version: "1"
6+
metadata-version: "2"
77
allowed-tools: Read, Write, Glob, Grep, Shell
88
argument-hint: "[optional: path to repo root, defaults to current project]"
9+
capabilities: chalk.setup, chalk.docs.bootstrap
10+
activation-intents: set up chalk, initialize chalk, bootstrap chalk
11+
activation-events: user-prompt, session-start
12+
activation-artifacts: .chalk/**, README.md, AGENTS.md
13+
risk-level: medium
914
---
1015

1116
Initialize a `.chalk/` folder for any repository, focused on **style transfer** — capturing everything an AI agent needs to replicate the project's architecture, coding conventions, design system, and visual identity.

0 commit comments

Comments
 (0)