mirror of
https://github.com/K-Dense-AI/claude-scientific-skills.git
synced 2026-03-27 07:09:27 +08:00
docs(references): port style guides, 24 diagram guides, and 9 templates from opencode
All content ported from borealBytes/opencode under Apache-2.0 license with
attribution headers prepended to each file.
- references/markdown_style_guide.md (~733 lines): full markdown formatting,
citation, collapsible sections, emoji, Mermaid integration, and template
selection guide
- references/mermaid_style_guide.md (~458 lines): full Mermaid standards —
emoji set, classDef color palette, accessibility (accTitle/accDescr),
theme neutrality (no %%{init}), and diagram type selection table
- references/diagrams/ (24 files): per-type exemplars, tips, and templates
for all Mermaid diagram types
- templates/ (9 files): PR, issue, kanban, ADR, presentation, how-to,
status report, research paper, project docs
Source: https://github.com/borealBytes/opencode
This commit is contained in:
Clayton Young
@@ -0,0 +1,312 @@
|
||||
<!-- Source: https://github.com/borealBytes/opencode | 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]_
|
||||
Reference in New Issue
Block a user