Retro Copilot

Name: Retro Copilot
Author: aktsmm

aktsmm/agent-skills

5 installs
23 repo stars
Updated August 4, 2026
aktsmm/agent-skills

retro-copilot is a skill that runs a retrospective and turns incident learnings into updates for personal ~/.copilot instructions, skills, agents, hooks and config.

About

This skill runs a retrospective that turns incident and conversation learnings into concrete updates for personal ~/.copilot assets: instructions, skills, agents, hooks and related config. It extracts reusable insights, passes them through a safety and scope gate, and prefers merging into existing files over creating new ones. A developer uses it after fixing a bug or hitting a recurring issue to persist durable rules into their Copilot setup.

Extracts reusable learnings from incidents and conversations into ~/.copilot assets
Routes each learning to instructions, skills, agents, hooks or config with rationale
Enforces a safety and scope gate that excludes secrets and memory targets

Retro Copilot by the numbers

5 all-time installs (skills.sh)
Ranked #13,065 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
Data as of Aug 5, 2026 (Skillselion catalog sync)

At a glance

retro-copilot capabilities & compatibility

Use cases: orchestration

From the docs

What retro-copilot says it does

インシデント・会話から再利用可能な知見を抽出し、`~/.copilot` 配下の instructions / skills / agents / hooks / related config へ反映するための変更案を作る。

SKILL.md

既定モードは `safe-auto`。

SKILL.md

npx skills add https://github.com/aktsmm/agent-skills --skill retro-copilot

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/aktsmm/agent-skills/retro-copilot.svg)](https://skillselion.com/skills/aktsmm/agent-skills/retro-copilot)

Installs	5
repo stars	★ 23
Last updated	August 4, 2026
Repository	aktsmm/agent-skills ↗

What it does

Turn incident and conversation learnings into safe updates for personal ~/.copilot instructions, skills, agents and hooks.

Who is it for?

Persisting reusable operational learnings into personal Copilot customization assets after an incident or review.

Skip if: Workspace/repository-specific content (use retro-workspace), VS Code User Data (use retro-user), or memory scopes.

When should I use this skill?

After solving a bug or a recurring issue, when a durable learning should be written into your ~/.copilot assets.

What you get

Reusable learnings distilled and merged into the right ~/.copilot asset with a documented target rationale.

Learnings summary
Change proposals
Target rationale

By the numbers

5-step workflow (Context to Validate & Output)
P1/P2/P3 priority by Impact x Recurrence

Files

SKILL.mdMarkdownGitHub ↗

Retro Copilot

インシデント・会話から再利用可能な知見を抽出し、~/.copilot 配下の instructions / skills / agents / hooks / related config へ反映するための変更案を作る。

When to Use

使う: バグ解決後 / 再発発生時 / レビューで .copilot 配下の個人用資産の設計ギャップが見つかったとき
使う: ~/.copilot/copilot-instructions.md、~/.copilot/instructions/**、~/.copilot/skills/**、~/.copilot/agents/**、~/.copilot/hooks/** へ反映すべき運用知見があるとき
使わない: typo など軽微修正のみ / 環境固有問題のみ
使わない: workspace / repository 固有の内容。代わりに retro-workspace を使う
使わない: VS Code User Data の内容。代わりに retro-user を使う

Core Rules

memory は反映先にしない
/memories/**、user memory、session memory、repo memory を対象にしない
既定モードは safe-auto。.copilot scope が明確で、Safety & Scope Gate を通過し、既存資産への小〜中規模な統合・更新で済む場合は、確認なしで反映まで実行してよい
review-only / 確認だけ / dry-run / プレビュー が明示された場合だけ、変更案の提示で停止する
次の場合だけユーザー確認で停止する: scope 判断が曖昧、大規模削除、公開・同期範囲変更、hook / config の高リスク変更、既存 agent / skill の意味を大きく変える変更、secret / 個人情報 / 環境固有値の扱いに迷う場合
新規ファイル作成より既存ファイルへの統合を優先する
他スコープの内容なら自分で編集せず handoff する

Workflow

Context -> Extract -> Safety & Scope Gate -> Decide Action & Target -> Validate & Output

Phase 1: Context Collection

入力（1つ以上必須）
エラーログ、diff/commit、会話履歴、ターミナル履歴、既存 .copilot 資産
既定の反映スコープ
~/.copilot 配下の個人グローバルカスタマイズ資産を優先する
workspace / repository や VS Code User Data へ反映すべき知見はこの skill では扱わず、handoff を提案する
memory 系スコープは反映先にしない
ターミナル観点
Exit Code != 0
Ctrl+C（中断）
同コマンド反復
長時間実行
Gate: 入力なしなら追加要求して停止

Phase 2: Extract Learnings

カテゴリ
設計原則（SRP/SSOT/idempotency）
ワークフロー
プロンプト設計
コンテキスト設計
エラーパターン
1件ごとに Learning / Evidence / Impact を作成
Gate: actionable な知見がなければ停止

Phase 2.5: Safety & Scope Gate

反映禁止または抽象化が必要な情報
secret、認証情報、API キー、接続文字列
個人情報、顧客情報、個人アカウント値
ローカル絶対パス、端末固有値、一時ディレクトリ
外部共有に不向きな会話本文やログ断片
No Memory Targets Gate
/memories/**、user memory、session memory、repo memory を反映先にしない
memory に残す必要がある依頼は、この skill では実行せず別タスクとして明示確認する
Scope Gate
~/.copilot 配下の資産に置くべき内容か確認する
workspace / repository や VS Code User Data に置くべき内容なら、この skill では反映せず handoff を提案する
Gate（全必須）
永続化する知見は再利用可能なルールに抽象化されている
証拠は必要最小限で、機微情報を含まない
~/.copilot 配下に置くべき内容か確認済み
No Memory Targets Gate を通過済み

Refactor Context Rules

SSOT を守る。重複定義は統合する
新規ファイル作成より既存ファイルへの統合を優先する
既存ファイルに 1 セクション追加や 1 ルール追記で済むなら、新規ファイルを作らない
単一ルール追加や導線追加は catch-all な既存ファイルを優先し、新規ファイルは最後の手段にする
新規ファイルは、既存ファイルの役割に収まらず Target Rationale で必要性を説明できる場合だけ許可する
50 行以下の小さいファイルは、明確な価値がない限り変更不要または最小差分とする
冗長説明は圧縮するが、根拠 URL・非自明な手順・運用メタコメントは消さない
Target Rationale では「なぜ新規作成でなく既存統合か」を必ず説明する

Phase 3: Decide Action & Target

優先度: Impact x Recurrence（P1/P2/P3）
反映先
共通原則 → ~/.copilot/copilot-instructions.md
domain instructions → ~/.copilot/instructions/**/*.instructions.md
skills → ~/.copilot/skills/**/SKILL.md
agents → ~/.copilot/agents/**/*.agent.md
hooks → ~/.copilot/hooks/**/*.json
related config → 次に限定する
~/.copilot/config.json
~/.copilot/settings.json
~/.copilot/permissions-config.json
~/.copilot/mcp-config.json
~/.copilot/mcp-oauth-config/**（customization と直接整合するものだけ）
反映禁止
workspace / repository の AGENTS.md、.github/**、workspace docs
VS Code User Data の *.prompt.md / *.instructions.md / *.agent.md
/memories/**、user memory、session memory、repo memory
command-history-state.json、session-store.db、vscode.session.metadata.cache.json
session-state/**、logs/**、pkg/**、crash-context/**、restart/** のようなランタイム生成物やキャッシュ
反映先ファイルが存在しない場合:
safe-auto で新規作成してよい。ただし既存資産に統合できる場合は統合を優先する
ディレクトリも不在なら、作成予定のパスと理由を示す
scope や公開可否に迷う場合だけユーザー承認後に重複/矛盾チェックへ進む

Decision Rules

まず既存 .copilot 資産へ統合できないかを見る
instructions は原則、skills はタスク手順、agents は役割分離、hooks は決定的自動化の棲み分けで選ぶ
新規作成は既存の役割に収まらない場合だけ
workspace / repository へ反映すべき内容は retro-workspace に handoff する
VS Code User Data へ反映すべき内容は retro-user に handoff する
memory 系スコープは反映先にしない
最小差分で反映する

Output Requirements

## Learnings
## Changes
## Target Rationale
## Review Checkpoint

## Review Checkpoint には最低限次を含める:

[ ] safe-auto executed or user approval obtained when gated
[ ] Copilot scope confirmed
[ ] No duplicate rules verified
[ ] Target files are writable
[ ] Safety & Scope Gate passed
[ ] No memory target selected

# Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)

## English

Copyright (c) 2025-2026 yamapan (aktsmm)

This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0
International License.

You are free to:

- **Share** — copy and redistribute the material in any medium or format
- **Adapt** — remix, transform, and build upon the material

Under the following terms:

- **Attribution** — You must give appropriate credit, provide a link to the
  license, and indicate if changes were made. You may do so in any reasonable manner,
  but not in any way that suggests the licensor endorses you or your use.

- **NonCommercial** — You may not use the material for commercial purposes.
  *(Please contact the author if you wish to use this material for commercial purposes.)*

- **ShareAlike** — If you remix, transform, or build upon the material, you must
  distribute your contributions under the same license as the original.

No additional restrictions — You may not apply legal terms or technological
measures that legally restrict others from doing anything the license permits.

**AI/ML Training Restriction** — Use of this content for AI/ML training, data
mining, or other analytical purposes is prohibited without explicit permission.

Full license text: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode

---

## 日本語

Copyright (c) 2025-2026 yamapan (aktsmm)

この作品はクリエイティブ・コモンズ 表示-非営利-継承 4.0 国際ライセンスの下に提供されています。

あなたは以下の条件に従う限り、自由に：

- **共有** — どのようなメディアやフォーマットでも資料を複製・再配布できます
- **翻案** — 資料をリミックス、変形、および加工することができます

以下の条件に従ってください：

- **表示** — あなたは適切なクレジットを表示し、ライセンスへのリンクを提供し、
  変更があったらその旨を示さなければなりません。これらは合理的であればどのような方法で
  行っても構いませんが、許諾者があなたやあなたの利用行為を支持していると示唆するような
  方法は除きます。

- **非営利** — あなたは営利目的でこの資料を利用してはなりません。
  （※商用利用をご希望の場合は、別途ご連絡ください。）

- **継承** — もしあなたがこの資料をリミックス、変形、または加工した場合、
  あなたはあなたの貢献部分を元の作品と同じライセンスの下で配布しなければなりません。

追加的な制約は課せません — あなたは、このライセンスが他の者に許諾することを法的に
制限するような法的条項や技術的手段を適用してはなりません。

**AI/MLトレーニング制限** — 本コンテンツをAI/MLモデルのトレーニング、データマイニング、
その他の解析目的での使用は明示的な許可なく禁止されています。

ライセンス全文: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.ja

---

## Special Permission for Microsoft Employees / Microsoft 社員向け特別許諾

### English

Microsoft Corporation employees are granted permission to use, copy, modify, and
distribute this material for any purpose within the scope of their employment
duties at Microsoft, including internal business use and customer-facing
activities, without the NonCommercial restriction of this license.

This special permission applies only to work performed as part of official
Microsoft business activities.

### 日本語

Microsoft Corporation の社員は、Microsoft での業務の範疇において、本資料を社内業務
および顧客対応を含むあらゆる目的で使用、複製、改変、配布することが許諾されます。
この場合、本ライセンスの「非営利」制限は適用されません。

この特別許諾は、Microsoft の公式な業務活動の一環として行われる作業にのみ適用されます。

---

## Disclaimer / 免責事項

### English

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR
A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

### 日本語

本ソフトウェアは「現状のまま」で提供され、明示または黙示を問わず、商品性、
特定目的への適合性、および権利非侵害についての保証を含むがこれに限定されない、
いかなる種類の保証も伴いません。作者または著作権者は、契約行為、不法行為、
またはそれ以外であろうと、ソフトウェアに起因または関連し、あるいはソフトウェアの
使用またはその他の扱いによって生じる一切の請求、損害、その他の責任について
責任を負いません。