AI agent skill · by @NeuroAIHub

Share Case

One-command community case sharing — capture research context from your session and submit to GitHub Discussions

Archived 2026-10-23 · Source updated 2026-10-02 · License: AGPL-3.0. Check the original repository for the latest version.

SKILL.md instructions

# Share Case

## Purpose

This meta-skill captures a researcher's experience using any skill in this repository and submits it as a structured case to GitHub Discussions. It handles all formatting and submission so users never need to leave their terminal or know Git.

## When to Use This Skill

Activate when the user:

- Says "share this case", "share my experience", "分享这个案例"
- Wants to document how they used a skill in their research
- Asks how to contribute a usage example

---

## Research Planning Protocol

Before starting the case sharing process, you MUST:

1. **Identify the skill used** — Which skill(s) from this repository were used in the current session?
2. **Clarify sharing scope** — What aspects of the experience does the user want to share?
3. **Declare what will be extracted** — List the specific conversation elements that will be included
4. **Note privacy considerations** — Are there dataset names, lab identifiers, or participant details that should be anonymized?
5. **Present the extraction plan to the user and WAIT for confirmation** before proceeding.

For detailed methodology guidance, see `skills/research-literacy/SKILL.md`.

## ⚠️ Verification Notice

This skill was generated by AI from academic literature. All parameters, thresholds, and citations require independent verification before use in research. If you find errors, please [open an issue](https://github.com/HaoxuanLiTHUAI/awesome_cognitive_and_neuroscience_skills/issues).

---

## Prerequisites

This skill supports two submission methods:

1. **Direct submission via `gh` CLI** (Recommended)
   - Requires `gh` CLI installed and authenticated
   - Run `gh auth status` to check
   - Install from https://cli.github.com/ and run `gh auth login`

2. **Manual submission via web browser**
   - No `gh` CLI required
   - Opens GitHub Discussions page in browser
   - User copies and pastes the generated case

The skill will check for `gh` availability and let the user choose their preferred method.

**GitHub Discussions** must be enabled on the repository. The skill submits to the "Show & Tell" category.

---

## Interactive Flow

### Step 1 — Quick Survey

Present these questions using multiple-choice format:

**Q1: Which skill did you use?**
- Auto-detect from the current session context (list skills that were activated)
- Let the user confirm or select manually from the full skill list

**Q2: What was your research scenario?**
- Formal experiment
- Coursework or teaching
- Method exploration
- Paper reproduction
- Other (free text)

**Q3: How helpful was the skill? (1-5)**
- 1 = Not helpful
- 2 = Slightly helpful
- 3 = Moderately helpful
- 4 = Very helpful
- 5 = Extremely helpful

**Q4: What was most valuable? (select all that apply)**
- Correct methodology guidance
- Validated parameters and thresholds
- Pitfall warnings
- Complete pipeline coverage
- Literature references
- Other (free text)

### Step 2 — Context Extraction

Extract the following from the current conversation:

1. **Research context** — The user's original research question and experimental setup
2. **Key recommendations** — The main suggestions the skill provided (parameters, methods, warnings)
3. **Follow-up adjustments** — Any modifications made during the conversation
4. **Outcome summary** — What the user ultimately decided to do

Format each as a concise paragraph. Do NOT include raw conversation transcripts — synthesize into readable summaries.

### Step 3 — User Review and Submission Choice

Display the complete case preview using the format below.

**First, check `gh` CLI availability:**

```bash
gh auth status 2>&1
```

**Then present submission options using AskUserQuestion:**

If `gh` is available:
- **Submit via gh CLI (Recommended)** — Direct submission to GitHub Discussions
- **Open in browser** — Manual submission via web interface
- **Delete sections** — Remove specific paragraphs before submitting
- **Anonymize** — Replace specific names (datasets, labs, participants)
- **Abort** — Cancel without submitting

If `gh` is NOT available:
- **Open in browser** — Manual submission via web interface
- **Delete sections** — Remove specific paragraphs before submitting
- **Anonymize** — Replace specific names (datasets, labs, participants)
- **Abort** — Cancel without submitting

**You MUST wait for explicit user confirmation before proceeding to Step 4.**

### Step 4 — Submit to GitHub

Based on the user's choice in Step 3:

#### Option A: Submit via `gh` CLI

Create a GitHub Discussion in the "Show & Tell" category.

**First, get repository and category IDs:**

```bash
gh api graphql -f query='
{
  repository(owner: "HaoxuanLiTHUAI", name: "awesome_cognitive_and_neuroscience_skills") {
    id
    discussionCategories(first: 10) {
      nodes {
        id
        name
      }
    }
  }
}'
```

**Then create the discussion:**

```bash
gh api graphql -f query='
mutation {
  createDiscussion(input: {
    repositoryId: "REPO_ID",
    categoryId: "SHOW_AND_TELL_CATEGORY_ID",
    title: "Community Case: SKILL_NAME",
    body: "CASE_BODY_HERE"
  }) {
    discussion {
      url
    }
  }
}'
```

On success, display the Discussion URL:
```
✅ Case shared successfully!
🔗 Discussion URL: [URL]

Thank you for contributing to the community!
```

On failure, fall back to Option B.

#### Option B: Open in Browser

1. Save the case locally to the current directory as `case-skill-name-YYYYMMDD.md`

2. Open the GitHub Discussions page:
```bash
xdg-open "https://github.com/HaoxuanLiTHUAI/awesome_cognitive_and_neuroscience_skills/discussions/new?category=show-and-tell" 2>/dev/null || \
open "https://github.com/HaoxuanLiTHUAI/awesome_cognitive_and_neuroscience_skills/discussions/new?category=show-and-tell" 2>/dev/null || \
echo "Please open: https://github.com/HaoxuanLiTHUAI/awesome_cognitive_and_neuroscience_skills/discussions/new?category=show-and-tell"
```

3. Inform the user:
```
✅ Case saved to: case-skill-name-YYYYMMDD.md

🌐 Opening GitHub Discussions in your browser...

📋 Next steps:
1. Title: "Community Case: [Skill Name]"
2. Copy the content from case-skill-name-YYYYMMDD.md
3. Paste it into the discussion body
4. Click "Start discussion"

Thank you for contributing to the community!
```

---

## Case Format Template

The submitted Discussion body uses this format:

```markdown
## Community Case: [skill-name]

### Quick Info
- **Skill used**: `[skill-name]`
- **Scenario**: [selected option from Q2]
- **Rating**: [stars from Q3, e.g., ⭐⭐⭐⭐]
- **Most valuable**: [selected options from Q4]

### Research Context
> [User's research question and experimental setup — synthesized from conversation]

### What the Skill Suggested
- [Key recommendation 1]
- [Key recommendation 2]
- [Key recommendation 3]

### What I Actually Did & Result
> [User's experience applying the recommendations and the outcome]

### User's Tips
> [Optional: Additional insights the user wants to share with the community]

---
*Submitted via the `share-case` meta-skill.*
```

---

## Privacy Principles

- **Nothing is submitted without explicit user confirmation** after full preview
- Users can remove any section or paragraph before submission
- Users can anonymize dataset names, lab names, and participant identifiers
- Users can choose to submit anonymously (no GitHub username attribution in the case body)
- The skill never auto-submits — the user must explicitly approve