MCP HubMCP Hub
SKILL·C69F9E

crit-story

tomasz-tomczyk
Mis à jour 27 days ago
4 vues
979
74
979
Voir sur GitHub
Métageneral

À propos

La compétence crit-story génère une documentation structurée de récits uniquement lorsqu'elle est explicitement invoquée via `/crit-story` ou une demande directe. Elle récupère et suit un guide de rédaction en temps d'exécution pour produire une sortie au format JSON, fonctionnant indépendamment des flux de travail habituels de revue de code. Les développeurs doivent l'utiliser spécifiquement pour la génération de récits, et non pour des revues de PR générales ou des analyses de différences.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add tomasz-tomczyk/crit -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/tomasz-tomczyk/crit
Git CloneAlternatif
git clone https://github.com/tomasz-tomczyk/crit.git ~/.claude/skills/crit-story

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

Author a crit story with crit story

This is a sibling skill to /crit — it does not run inside the normal review loop. Invoke it deliberately only when the user explicitly asks for story generation; do not infer it from generic review, PR, or diff-review requests.

Step 1: Fetch the guide

crit story --guide

This prints the resolved authoring guide (the user's customized version if they have one — always invoke this at runtime rather than reusing this skill's own prose) followed by --- and the JSON schema for the fields you must emit. Read and follow that guide's principles and JSON shape exactly — it is the source of truth, not this file.

Step 2: Write the prep file

crit story --prep /tmp/crit-story-prep.txt

This writes the full, untrimmed diff (commit messages + every hunk with its (file_path, old_start) id) to the given path and prints the path. Read that file — the diff is never inlined into the guide prompt.

Step 3: Author the story JSON

Following the guide from Step 1, cluster hunks by theme (not by file) and write a JSON object with only prologue, chapters, and support to a temp file, e.g. /tmp/crit-story.json. Do not include version, generated_at, agent, base_sha, head_sha, scope_fingerprint, or coverage — crit fills those in.

Step 4: Ingest

crit story --story-file /tmp/crit-story.json

Exit 0 means the story was saved (crit opens the browser to show it). Exit 1 means it was rejected — the coverage report (missing/duplicated hunks) is printed to stdout as JSON on every attempt, success or failure. If rejected:

  • duplicated non-empty: a hunk is claimed by two chapters (or a chapter and support). Decide where it belongs and re-ingest.
  • missing non-empty with auto_repaired: true on exit 0: crit already back-filled the omissions into support[]. Optionally re-author to place them deliberately.
  • A drift error ("diff changed since prep"): re-run crit story --prep and re-author from the fresh prep file.

What this skill does NOT do

  • It does not call crit comment, crit push, or crit share — those are separate flows.
  • It does not produce review-level human comments.
  • It does not run as part of the generic /crit review loop.

Dépôt GitHub

tomasz-tomczyk/crit
Chemin: integrations/claude-code/skills/crit-story
0
agentic-codingai-agentsai-toolsclicode-reviewdeveloper-tools
FAQ

Questions fréquentes

Qu’est-ce que le Skill crit-story ?

crit-story est un Skill Claude créé par tomasz-tomczyk. Un Skill regroupe des instructions et des ressources que Claude charge à la demande pour effectuer des tâches liées à crit-story sans consigne supplémentaire.

Comment installer crit-story ?

Utilisez les commandes d’installation de cette page : ajoutez crit-story à Claude Code comme plugin ou clonez son dépôt dans votre dossier skills, puis redémarrez Claude pour charger le Skill.

À quelle catégorie appartient crit-story ?

crit-story appartient à la catégorie Méta.

crit-story est-il gratuit ?

Oui. crit-story est référencé sur AIMCP et son installation est gratuite.

Compétences associées

content-collections
Méta

Cette compétence propose une configuration éprouvée en production pour Content Collections, un outil axé sur TypeScript qui transforme des fichiers Markdown/MDX en collections de données typées de manière sûre avec une validation Zod. Utilisez-la lors de la création de blogs, de sites de documentation ou d'applications Vite + React riches en contenu pour garantir la sécurité de typage et la validation automatique du contenu. Elle couvre tout, de la configuration du plugin Vite et de la compilation MDX à l'optimisation des déploiements et la validation des schémas.

Voir la compétence
polymarket
Méta

Cette compétence permet aux développeurs de créer des applications avec la plateforme de marchés prédictifs Polymarket, incluant l'intégration d'API pour le trading et les données de marché. Elle fournit également une diffusion de données en temps réel via WebSocket pour surveiller les transactions en direct et l'activité du marché. Utilisez-la pour mettre en œuvre des stratégies de trading ou pour créer des outils traitant les mises à jour de marché en direct.

Voir la compétence
creating-opencode-plugins
Méta

Cette compétence aide les développeurs à créer des plugins OpenCode qui s'interconnectent avec plus de 25 types d'événements tels que les commandes, les fichiers et les opérations LSP. Elle fournit la structure du plugin, les spécifications de l'API événementielle et les modèles d'implémentation pour les modules JavaScript/TypeScript. Utilisez-la lorsque vous avez besoin d'intercepter, de surveiller ou d'étendre le cycle de vie de l'assistant IA OpenCode avec une logique personnalisée pilotée par les événements.

Voir la compétence
sglang
Méta

SGLang est un framework de service LLM haute performance spécialisé dans la génération rapide et structurée pour les workflows JSON, regex et agentiques grâce à son cache de préfixe RadixAttention. Il offre une inférence nettement plus rapide, particulièrement pour les tâches avec des préfixes répétés, ce qui le rend idéal pour les sorties complexes et structurées ainsi que les conversations multi-tours. Choisissez SGLang plutôt que des alternatives comme vLLM lorsque vous avez besoin d'un décodage contraint ou que vous construisez des applications avec un partage étendu de préfixes.

Voir la compétence