本文へ移動
cccskills
無料GitHub で公開

knowledge-base-update

Use this skill whenever you learn something important during a conversation: a key architectural decision, a project-specific convention, a bug root-cause, a 3rd-party API quirk, or any fact that would help a future agent avoid re-doing the same research. Writes structured entries to the project's knowledge base so that context persists across conversations and agents.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md4.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

<!-- TÜRKÇE AÇIKLAMA ─────────────── Bu skill, konuşma sırasında öğrenilen önemli bilgilerin kaybolmaması için kullanılır. Mimari kararlar, proje kuralları, bug köken nedenleri, 3. parti servis tuzakları veya tekrar araştırılmasını istemediğin her şeyi yapılandırılmış biçimde .agent/knowledge/ dizinine yazar. Böylece gelecekteki agent'lar aynı soruyu sıfırdan araştırmak zorunda kalmaz. NE ZAMAN: Önemli bir karar alındığında, sürpriz bir bug çözüldüğünde, bir API davranışı belgelendiğinde, yeni bir proje kuralı oluşturulduğunda. ÇIKTI: .agent/knowledge/<slug>.md + INDEX.md satırı -->

Knowledge Base Update Skill

When to Trigger

Activate this skill when any of the following occur:

  • An architectural or tech-stack decision is made (and the why matters)
  • A non-obvious bug is fixed (root cause + fix documented)
  • A 3rd-party service/API has a quirk, limit, or gotcha discovered
  • A project convention is established (naming, folder structure, patterns)
  • A research question is answered after significant investigation
  • A "we tried X and it failed because Y" moment happens

Step-by-Step Process

1. Identify the Entry Type

Choose the category that best describes what was learned:

TypeWhen to Use
decisionArchitecture, tech choices, trade-offs
conventionNaming rules, code patterns, folder structures
bugRoot cause + fix for a non-obvious problem
gotcha3rd-party quirk, env issue, edge case trap
researchAnswer to a question requiring significant investigation

2. Determine the File Path

Write to: .agent/knowledge/<slug>.md

  • slug = kebab-case summary of the topic (e.g., auth-token-refresh-strategy)
  • If an entry for this topic already exists, update it rather than creating a new file
  • Group related topics under subfolders: .agent/knowledge/auth/, .agent/knowledge/infra/, etc.

3. Write the Entry

Use this exact template:

---
type: <decision|convention|bug|gotcha|research>
topic: <Short human-readable title>
date: <YYYY-MM-DD>
tags: [<tag1>, <tag2>]
---

## Summary
<One or two sentences — what was learned, bottom line up front>

## Context
<Why this came up. What problem were we solving?>

## Decision / Finding
<The actual content. Be specific. Include code snippets if helpful.>

## Rationale
<Why this choice over alternatives. What alternatives were rejected and why.>

## Consequences
<What does this affect going forward? What to watch out for?>

## References
- <File path, PR link, conversation snippet, or external URL>

4. Update the Index

After writing the entry, append a one-line summary to .agent/knowledge/INDEX.md:

| <date> | <type> | [<topic>](./<path>.md) | <one-line summary> |

If INDEX.md doesn't exist yet, create it with this header first:

# Project Knowledge Base

| Date | Type | Topic | Summary |
|------|------|-------|---------|

5. Confirm to User

After writing, report:

  • What was saved and where
  • The one-line summary that was added to the index

Rules

  • Never summarize vaguely. "We decided to use X" is useless without why.
  • Include the anti-pattern. If something was tried and rejected, document it — that's often the most valuable knowledge.
  • Keep entries atomic. One topic per file. Don't bundle unrelated decisions.
  • Date is mandatory. Future agents need to know how fresh this knowledge is.
  • If in doubt, write it. The cost of a redundant entry is low. The cost of a missing one is re-doing the work.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Before committing to an implementation plan, run this skill to stress-test the proposed architecture. Catches over-engineering, circular dependencies, missing failure modes, security gaps, and scalability cliffs — before any code is written. Acts as a "second eye" on the plan.

日本語の概要は準備中です。原文の説明を表示しています。

omergocmen/vibe-coder-kit932026年6月4日 更新

Systematic code review skill covering both requesting a review (pre-commit checklist) and receiving and responding to review feedback. Checks code quality, security, test coverage, architectural alignment, and documentation before any code is committed.

日本語の概要は準備中です。原文の説明を表示しています。

omergocmen/vibe-coder-kit932026年6月4日 更新

Periodically scan project dependencies for security vulnerabilities, outdated packages, and unused dependencies. Produces a prioritized action report. Run before every major release and at least once per month.

日本語の概要は準備中です。原文の説明を表示しています。

omergocmen/vibe-coder-kit932026年6月4日 更新

After any significant code change — new feature, API modification, config change, or architectural refactor — run this skill to identify which documentation files are now stale and update them. Keeps docs and code from drifting apart.

日本語の概要は準備中です。原文の説明を表示しています。

omergocmen/vibe-coder-kit932026年6月4日 更新

github

無料

Manages all git operations (commit, push, branch management, PR creation) in a standardized, safe, and consistent way. Automatically runs the code-review skill before any commit. Enforces Conventional Commits standard. Handles the full lifecycle: branch → review → commit → push → PR.

日本語の概要は準備中です。原文の説明を表示しています。

omergocmen/vibe-coder-kit932026年6月4日 更新

When something breaks in production: triage the severity, gather evidence, identify root cause, deploy a fix or mitigation, and write a post-mortem. Provides a calm, structured process for high-stress moments.

日本語の概要は準備中です。原文の説明を表示しています。

omergocmen/vibe-coder-kit932026年6月4日 更新

omergocmen のスキルをすべて見る

このスキルの問題を報告する