# OrbitOS Skills Reference

These skills are from the OrbitOS productivity framework and are NOT included in this project.
They must be installed separately in the Hermes skill system (`~/.hermes/skills/`).

This reference documents how moreminimore-service skills call OrbitOS skills.

---

## obsidian

**Purpose:** Read, search, create, and edit notes in the Obsidian vault.

**When mm* skills use it:**
- Reading research notes from `30_Research/`
- Creating article briefs in `60_Articles/`
- Searching vault for existing content
- Updating frontmatter status fields

**Key operations:**
```
read_file(path)           — read a note
search_files(pattern)     — search vault content
write_file(path, content) — create a note
patch(path, old, new)     — edit specific parts
```

**Vault path:** `~/vault/` (resolve before calling file tools)

**Critical rules:**
- No empty line after frontmatter `---`
- Frontmatter MUST be at line 1
- Use wikilinks `[[Note Name]]` for internal links
- Use array syntax for tags: `tags: [tag1, tag2]`

---

## orbites-research

**Purpose:** Deep research workflow — investigate a topic, create main research note, extract atomic wiki concepts.

**When mm* skills use it:**
- `mm-article-idea-extract` calls this for deep topic research
- Produces structured notes in `30_Research/` + atomic concepts in `40_Wiki/`

**How to invoke:**
```
Load skill: orbites-research
Provide: topic + user context
It will: create research plan → execute → produce notes
```

**Output structure:**
```
30_Research/<Area>/<Topic>/<Topic>.md    ← main research note
40_Wiki/<Category>/<Concept>.md          ← atomic concepts
```

**Frontmatter format:**
```yaml
---
type: reference
created: YYYY-MM-DD
area: "[[AreaName]]"
tags: [research, topic-tags]
status: complete
---
```

---

## orbites-parse-knowledge

**Purpose:** Take unstructured text and parse it into structured vault content (research notes + wiki concepts).

**When mm* skills use it:**
- `mm-article-idea-extract` uses this to structure research findings
- Converts raw web content into organized vault notes

**How to invoke:**
```
Load skill: orbites-parse-knowledge
Provide: unstructured text + topic context
It will: identify area → create research note → extract wiki concepts
```

**Output:**
```
30_Research/<Area>/<Topic>/<Topic>.md    ← structured research note
40_Wiki/<Category>/<Concept>.md          ← atomic concepts
```

---

## orbites-obsidian-markdown

**Purpose:** Reference for Obsidian Flavored Markdown — wikilinks, callouts, embeds, frontmatter.

**When mm* skills use it:**
- Any skill that creates or edits vault notes
- Ensures correct frontmatter format
- Validates wikilink syntax

**Key formats:**

**Wikilinks:**
```markdown
[[Note Name]]
[[Note Name|Display Text]]
[[Note Name#Heading]]
![[image.png|300]]
```

**Callouts:**
```markdown
> [!note] Title
> Content here
```

**Frontmatter:**
```yaml
---
title: My Note
tags: [tag1, tag2]
status: in-progress
---
```

**Critical DO NOT:**
- No empty line after frontmatter `---`
- No duplicate keys in frontmatter
- Frontmatter MUST be at line 1

---

## Installation

To install OrbitOS skills:

```bash
# Clone OrbitOS skill bundle
git clone https://github.com/MarsWang42/OrbitOS.git /tmp/orbitos

# Copy skills to Hermes
cp -r /tmp/orbitos/skills/* ~/.hermes/skills/

# Verify
hermes skills list | grep orbites
```

Or install via Hermes:
```
hermes skill install orbitos
```