yosnap/ck:ck-help

ClaudeKit Help

All-in-one ClaudeKit guide. Run the script and present output based on type markers.

Intent Validation

The script uses keyword matching with smart weighting. After getting results, validate against these heuristics:

| Sentence Pattern | Primary Intent | Example | |------------------|----------------|---------| | [action verb] my [object] | The action verb | "commit my changes" → git | | [context] [subject noun] | The subject noun | "setup notifications" → notifications | | [noun] [noun] | Last noun (topic) | "discord webhook" → notifications |

Action verbs (high intent when first): fix, test, commit, push, build, create, review, deploy, run, check, find, plan, refactor

Context words (low intent, modify subject): setup, add, start, new, my, the, configure

Override script only if: result clearly mismatches the sentence pattern above. Otherwise trust the algorithm.

Translation

IMPORTANT: Always translate $ARGUMENTS to English before passing to script.

The Python script only understands English keywords. If $ARGUMENTS is in another language:

1. Translate $ARGUMENTS to English
2. Pass the translated English string to the script

Execution

python .claude/skills/ck-help/scripts/ck-help.py "$ARGUMENTS"

Output Type Detection

The script outputs a type marker on the first line: @CK_OUTPUT_TYPE:<type>

Read this marker and adjust your presentation accordingly:

@CK_OUTPUT_TYPE:comprehensive-docs

Full documentation (config, schema, setup guides).

Presentation:

1. Show the COMPLETE script output verbatim
2. THEN ADD helpful context: real-world examples, common gotchas, practical scenarios
3. End with a specific follow-up question

@CK_OUTPUT_TYPE:category-guide

Workflow guides for skill categories.

Presentation:

1. Show the complete workflow and command list
2. ADD practical context: when to use vs alternatives, real examples, transition tips
3. Offer to help with a specific task

@CK_OUTPUT_TYPE:command-details

Single skill/subcommand documentation.

Presentation:

1. Show full skill info from script
2. ADD: concrete usage example, when this skill shines vs alternatives, common flags
3. Offer to run the skill flow for them

@CK_OUTPUT_TYPE:search-results

Search matches for a keyword.

Presentation:

1. Show all matches from script
2. HELP user navigate: group by relevance, suggest most likely match, offer to explain
3. Ask what they're trying to accomplish

@CK_OUTPUT_TYPE:task-recommendations

Task-based skill suggestions.

Presentation:

1. Show recommended skills from script
2. EXPLAIN the reasoning: why these skills fit, suggested order, what each step accomplishes
3. Offer to start with the first recommended command

Key Principle

Script output = foundation. Your additions = value-add.

Never replace or summarize the script output. Always show it fully, then enhance with your knowledge and context.

Important: Correct Workflows

• /ck:plan → /ck:cook: Best for high-risk or complex changes
• /ck:cook: Standalone for straightforward implementation
• NEVER claim /ck:plan is mandatory before /ck:cook