creating-knowledge-entries

terrylica 的头像作者 terrylica

通过一次性输入创建结构化的 GitHub 问题知识条目。处理自动格式化、AI 标签、标题提取和发布。当用户想要分享技巧、记录解决方案、创建操作方法或向基础添加任何知识时使用。

📖 中文导读:通过一次性输入创建结构化的 GitHub 问题知识条目。处理自动格式化、AI 标签、标题提取和发布。当用户想要分享技巧、记录解决方案、创建操作方法或向基础添加任何知识时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: creating-knowledge-entries description: Create structured GitHub Issue knowledge entries with one-shot input. Handles auto-formatting, AI labeling, title extraction, and publishing. Use when user wants to share tips, document solutions, create how-tos, or add any knowledge to the base.

Creating Knowledge Entries

One-shot knowledge capture with full automation.

Trigger Detection

Activate this skill when user says:

  • "I want to share knowledge"
  • "Let me document this"
  • "Add to knowledge base"
  • "Share a tip"
  • "Document this solution"
  • "Create how-to"

Workflow

Step 1: Minimal Prompt

Just paste what you want to share (any format is fine):

Critical: Do NOT ask user about types, categories, or labels. User shares freely, AI decides everything autonomously.

Step 2: Autonomous Processing

Process user input completely autonomously:

  1. Analyze existing labels in repo (understand current taxonomy)
  2. Detect content type via AI (tip, how-to, troubleshooting, reference, example, question)
  3. Extract title via AI
  4. Format content with appropriate template
  5. Suggest labels based on existing taxonomy (or create new if empty)
  6. Link to related knowledge via automated search
  7. Create GitHub Issue with all decisions made

See REFERENCE.md for complete automation pipeline.

Step 3: Confirmation (What Was Decided)

✅ Created Issue #{number}!

📋 What I decided:
─────────────────────────────────────────
Title:    "{AI-extracted-title}"

Type:     {type-emoji} {type-name}

Labels:   {label1, label2, label3}
          (based on existing repo labels)

Format:   Structured with sections
          {auto-generated-sections}

Related:  Linked to #{n1}, #{n2}
─────────────────────────────────────────
🔗 {issue-url}

Search: gh search issues "{keywords}" --label={primary-label}

Quick Example

Input:

tmux is great for persistent sessions. ctrl-b d to detach and
tmux attach to reattach. Useful when ssh connections drop.

Output: Formatted GitHub Issue:

  • Title: "Terminal: Using tmux for Persistent SSH Sessions"
  • Labels: terminal, tips, workflow
  • Content: Structured with "What It Does", "When to Use It", "Key Commands" sections
  • Related: Auto-linked to similar terminal tips

Dependencies

  • gh CLI (issue creation)
  • gh-models extension (AI labeling, title extraction)
  • jq (JSON processing)

Error Handling

Content too short (< 20 chars):

I need more content to create a useful knowledge entry.
Could you provide at least a sentence or two?

API fails:

⚠️  Couldn't create issue automatically. Here's the formatted content:
[formatted markdown shown]

Create manually: gh issue create --title "..." --body-file content.md

Complete Reference

For detailed automation pipeline, templates, and examples, see REFERENCE.md.


Repository: https://github.com/terrylica/claude-code-skills-github-issues