메뉴
Save session learnings as a new skill plugin. Use after experiments, debugging sessions, or when you want to preserve team knowledge.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Search team knowledge before starting work. Use when starting experiments, debugging unfamiliar errors, or before implementing features with unknowns.
Best practices for writing effective skill documentation. Use when creating new skills, improving skill discoverability, or documenting failed attempts.
GitHub Actions CI for validating skill plugins. Use when setting up CI/CD for a skills marketplace or enforcing plugin quality.
| name | learn |
| description | Save session learnings as a new skill plugin. Use after experiments, debugging sessions, or when you want to preserve team knowledge. |
| user-invocable | false |
Capture session learnings and create a new skill plugin with PR.
| Item | Details |
|---|---|
| Date | 2025-12-29 |
| Objective | Automate knowledge capture from sessions into searchable skill plugins |
| Outcome | ✅ Operational |
| Mistake | Symptom | Fix |
|---|---|---|
Forgot .claude-plugin/plugin.json | "Missing .claude-plugin/plugin.json" | Create with name, version, description, category, date |
| Description < 20 chars | "Description too short" | Add "Use when:" trigger conditions |
| Failed Attempts as prose | "should contain a table" | Use pipe-delimited table format |
| Missing frontmatter | "missing YAML frontmatter" | Add --- delimiters at top of SKILL.md |
| Wrong category | "Invalid category" | Use one of 9 approved categories |
## Workflow instead of ## Verified Workflow | "Missing Verified Workflow section" | Use exact header name |
| SessionEnd hook | Hook doesn't display messages to user | Use UserPromptSubmit hook instead |
| Committed without validating | PR fails CI | Run python3 scripts/validate_plugins.py skills/ before commit |
| Attempt | Why Failed | Lesson Learned |
|---|---|---|
| Auto-trigger on every session | User fatigue from constant prompts | Use >10 messages threshold |
| Generic skill names | Hard to find later via /advise | Enforce kebab-case with category prefix |
| Optional Failed Attempts section | Most valuable content missing | Make failures REQUIRED in template |
| Single references/notes.md | Information overload in one file | Split into experiment-log + troubleshooting |
| No environment capture | "Works on my machine" problems | Add environment table to Overview section |
| Committing without validation | Bad plugins entered registry | Run validate_plugins.py before commit |
N/A — this skill describes a workflow pattern.
commands/learn.md for the full command implementationvalidation-workflow for CI validation detailsdocumentation-patterns for writing quality skills