mirror of
https://github.com/K-Dense-AI/claude-scientific-skills.git
synced 2026-03-27 07:09:27 +08:00
e05e5373d0
All 40 references to borealBytes/opencode updated to the correct source: https://github.com/SuperiorByteWorks-LLC/agent-project Affected files: SKILL.md, all 24 diagram guides, 9 templates, issue and PR docs, plus assets/examples/example-research-report.md (new file). The example report demonstrates full skill usage: flowchart, sequence, timeline, xychart, radar diagrams — all with accTitle/accDescr and classDef colors, no %%{init}. Covers HEK293T CRISPR editing efficiency as a realistic scientific context.
313 lines
7.9 KiB
Markdown
313 lines
7.9 KiB
Markdown
<!-- Source: https://github.com/SuperiorByteWorks-LLC/agent-project | License: Apache-2.0 | Author: Clayton Young / Superior Byte Works, LLC (Boreal Bytes) -->
|
||
|
||
# Presentation / Briefing Template
|
||
|
||
> **Back to [Markdown Style Guide](../markdown_style_guide.md)** — Read the style guide first for formatting, citation, and emoji rules.
|
||
|
||
**Use this template for:** Slide-deck-style documents, research presentations, briefings, lectures, walkthroughs, or any content that would traditionally be a PowerPoint. Designed to read well as a standalone document AND to serve as speaker-ready presentation notes.
|
||
|
||
**Key features:** Collapsible speaker notes under every section, structured flow from context through content to action items, figure captions, and footnote citations.
|
||
|
||
---
|
||
|
||
## How to Use
|
||
|
||
1. Copy this file to your project
|
||
2. Replace all `[bracketed placeholders]` with your content
|
||
3. Delete sections that don't apply (but keep the core flow)
|
||
4. Add/remove content topics (H3s under 📚 Content) as needed
|
||
5. Follow the [Markdown Style Guide](../markdown_style_guide.md) for all formatting
|
||
6. Add [Mermaid diagrams](../mermaid_style_guide.md) wherever a concept benefits from a visual
|
||
|
||
---
|
||
|
||
## Template Structure
|
||
|
||
The presentation follows a 6-section flow. Each section has an H2 with one emoji, content, and optional collapsible speaker notes.
|
||
|
||
```
|
||
1. 🏠 Housekeeping — Logistics, context, announcements
|
||
2. 📍 Agenda — What we'll cover, with time estimates
|
||
3. 🎯 Objectives — What the audience will walk away with
|
||
4. 📚 Content — The main body (multiple H3 topics)
|
||
5. ✍️ Action Items — What happens next, who owns what
|
||
6. 🔗 References — Citations, resources, further reading
|
||
```
|
||
|
||
---
|
||
|
||
## The Template
|
||
|
||
Everything below the line is the template. Copy from here:
|
||
|
||
---
|
||
|
||
# [Presentation Title]
|
||
|
||
_[Context line — project, team, date, or purpose]_
|
||
|
||
---
|
||
|
||
## 🏠 Housekeeping
|
||
|
||
- [Logistics item or announcement]
|
||
- [Important deadline or reminder]
|
||
- [Any prerequisite context the audience needs]
|
||
|
||
<details>
|
||
<summary><strong>💬 Speaker Notes</strong></summary>
|
||
|
||
- **Timing:** 2–3 minutes for this section
|
||
- **Tone:** Conversational, get the room settled
|
||
- [Specific note about announcement context]
|
||
- [Transition line:] "With that covered, here's our plan for today..."
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
## 📍 Agenda
|
||
|
||
- [x] Housekeeping (3 min)
|
||
- [ ] [Topic 1 name] (10 min)
|
||
- [ ] [Topic 2 name] (15 min)
|
||
- [ ] [Topic 3 name] (15 min)
|
||
- [ ] Action items and Q&A (10 min)
|
||
|
||
**Total:** [estimated time]
|
||
|
||
<details>
|
||
<summary><strong>💬 Speaker Notes</strong></summary>
|
||
|
||
- Reference this agenda when transitioning between topics
|
||
- If running long on a topic, note what you'll compress
|
||
- "We have a natural break around the halfway point"
|
||
- Adjust timing based on audience engagement — questions are good
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
## 🎯 Objectives
|
||
|
||
After this presentation, you'll be able to:
|
||
|
||
- **[Action verb]** [specific, measurable outcome]
|
||
- **[Action verb]** [specific, measurable outcome]
|
||
- **[Action verb]** [specific, measurable outcome]
|
||
|
||
<details>
|
||
<summary><strong>💬 Speaker Notes</strong></summary>
|
||
|
||
- Reference these objectives throughout the presentation
|
||
- "This connects back to our first objective..."
|
||
- At the end, revisit: "Let's check — did we hit all three?"
|
||
- **Strong action verbs:** Identify, Analyze, Compare, Evaluate, Design, Implement, Explain, Distinguish, Create, Apply
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
## 📚 Content
|
||
|
||
### [Topic 1 title]
|
||
|
||
[Opening context — why this matters, what problem it solves]
|
||
|
||
**Key points:**
|
||
|
||
- [Point 1 with brief explanation]
|
||
- [Point 2 with brief explanation]
|
||
- [Point 3 with brief explanation]
|
||
|
||
Image placeholder: `images/slide-[filename].png`
|
||
_Figure 1: [What this image demonstrates]_
|
||
|
||
> 💡 **Key insight:** [The one-liner the audience should remember from this topic]
|
||
|
||
<details>
|
||
<summary><strong>💬 Speaker Notes</strong></summary>
|
||
|
||
### Teaching strategy
|
||
|
||
- **Open with a question:** "[Engaging question for the audience]?"
|
||
- Take 2–3 responses
|
||
- "Good thinking. Here's how this actually works..."
|
||
|
||
### Core explanation (3–5 min)
|
||
|
||
- Start with the definition/concept
|
||
- Walk through step by step
|
||
- Use a real-world example: "[Specific scenario]"
|
||
|
||
### Common misconceptions
|
||
|
||
- **What people think:** [Misconception]
|
||
- **What's actually true:** [Reality]
|
||
- **How to address it:** [Reframe]
|
||
|
||
### Transition
|
||
|
||
- "Now that we understand [concept], let's look at how it applies to..."
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
### [Topic 2 title]
|
||
|
||
[Context and explanation]
|
||
|
||
**Comparison of approaches:**
|
||
|
||
| Approach | Best for | Tradeoffs |
|
||
| ---------- | ---------- | --------- |
|
||
| [Option A] | [Scenario] | [Pro/con] |
|
||
| [Option B] | [Scenario] | [Pro/con] |
|
||
| [Option C] | [Scenario] | [Pro/con] |
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
accTitle: [Short title for this diagram]
|
||
accDescr: [One sentence describing what the diagram shows]
|
||
|
||
step1[⚙️ Step one] --> step2[🔍 Step two] --> step3[✅ Step three]
|
||
```
|
||
|
||
[Explanation of what the diagram shows and why it matters]
|
||
|
||
<details>
|
||
<summary><strong>💬 Speaker Notes</strong></summary>
|
||
|
||
### Walk through each option (5–6 min)
|
||
|
||
**Option A:**
|
||
|
||
- "Used when [scenario]"
|
||
- "Advantage: [benefit]"
|
||
- "Disadvantage: [drawback]"
|
||
|
||
**Option B:**
|
||
|
||
- "Used when [scenario]"
|
||
- "Advantage: [benefit]"
|
||
- "Disadvantage: [drawback]"
|
||
|
||
### Decision-making exercise
|
||
|
||
- Ask: "Given [scenario], which would you choose?"
|
||
- Take responses, discuss reasoning
|
||
- "In practice, professionals choose based on [criteria]"
|
||
|
||
### Real-world example
|
||
|
||
- "[Company/project] chose Option B because [reasoning]"
|
||
- "The result was [outcome]"
|
||
- "This matters because [relevance to audience]"[^1]
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
### [Topic 3 title]
|
||
|
||
[Context and explanation]
|
||
|
||
**Process:**
|
||
|
||
1. [First step with explanation]
|
||
2. [Second step with explanation]
|
||
3. [Third step with explanation]
|
||
|
||
> ⚠️ **Common pitfall:** [What goes wrong and how to avoid it]
|
||
|
||
[Deeper explanation, examples, or data supporting the topic]
|
||
|
||
<details>
|
||
<summary><strong>💬 Speaker Notes</strong></summary>
|
||
|
||
### Interactive element
|
||
|
||
- Pause at step 2: "What happens next?"
|
||
- Take guesses before revealing step 3
|
||
- "Why does this matter? Because [stakes]"
|
||
|
||
### If audience is advanced
|
||
|
||
- Skip the basics, jump to: "[Advanced angle]"
|
||
- Challenge question: "What if [scenario changed]?"
|
||
|
||
### If audience is struggling
|
||
|
||
- Slow down, repeat the analogy
|
||
- "Think of it like [simple comparison]"
|
||
- Offer to cover more in Q&A
|
||
|
||
### Timing
|
||
|
||
- This should take about [N] minutes
|
||
- If running long, compress the [specific part]
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
## ✍️ Action items
|
||
|
||
### Next steps
|
||
|
||
| Action | Owner | Due |
|
||
| ---------------------- | ------------- | ------ |
|
||
| [Specific action item] | [Person/team] | [Date] |
|
||
| [Specific action item] | [Person/team] | [Date] |
|
||
| [Specific action item] | [Person/team] | [Date] |
|
||
|
||
### Key takeaways
|
||
|
||
1. **[Takeaway 1]** — [one sentence summary]
|
||
2. **[Takeaway 2]** — [one sentence summary]
|
||
3. **[Takeaway 3]** — [one sentence summary]
|
||
|
||
<details>
|
||
<summary><strong>💬 Speaker Notes</strong></summary>
|
||
|
||
- Walk through each action item explicitly
|
||
- "Who owns this? When is it due?"
|
||
- "Questions about any of these?"
|
||
- Revisit the objectives: "Did we hit all three?"
|
||
- "Thank you for your time. I'm available for follow-up at [contact]."
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
## 🔗 References
|
||
|
||
### Sources cited
|
||
|
||
_All footnote references from the presentation are collected here:_
|
||
|
||
[^1]: [Author/Org]. ([Year]). "[Title]." _[Publication]_. <https://example.com>
|
||
|
||
### Further reading
|
||
|
||
- [Resource title](https://example.com) — Why this is useful
|
||
- [Resource title](https://example.com) — What it provides
|
||
|
||
### Tools mentioned
|
||
|
||
- [Tool name](https://example.com) — Purpose and how to access
|
||
|
||
<details>
|
||
<summary><strong>💬 Speaker Notes</strong></summary>
|
||
|
||
- "These resources are available in the shared document"
|
||
- "Start with [specific resource] — it's the most practical"
|
||
- "If you want to go deeper, [specific resource] covers the advanced topics"
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
_Last updated: [Date]_
|