Add OrbitOS skills (bundled)

- orbites-research: deep research workflow
- orbites-parse-knowledge: structure unstructured text
- orbites-obsidian-markdown: Obsidian markdown reference
- obsidian: vault read/write/search
- Updated README: 20 skills total, OrbitOS bundled
This commit is contained in:
Kunthawat Greethong
2026-07-02 10:04:21 +07:00
parent 7b5af16f6d
commit 7bf147069e
5 changed files with 293 additions and 7 deletions

View File

@@ -8,7 +8,7 @@ Content pipeline and marketing automation system for moreminimore-service client
Data Stage → Content Stage → Publish Article → Social Stage → Publish Social → Analytics Data Stage → Content Stage → Publish Article → Social Stage → Publish Social → Analytics
``` ```
### Skills (16 total) ### Skills (20 total)
**Core pipeline (mm*):** **Core pipeline (mm*):**
- `mm-content-orchestrator` — top-level pipeline coordinator - `mm-content-orchestrator` — top-level pipeline coordinator
@@ -29,13 +29,13 @@ Data Stage → Content Stage → Publish Article → Social Stage → Publish So
- `graphic-designer` — graphics - `graphic-designer` — graphics
- `xurl` — X/Twitter API - `xurl` — X/Twitter API
**External (OrbitOS — install separately):** **OrbitOS (bundled in `skills/orbitos/`):**
- `obsidian` — vault read/write - `obsidian` — vault read/write/search
- `orbites-research` — deep research - `orbites-research` — deep research workflow
- `orbites-parse-knowledge` — structure text - `orbites-parse-knowledge` — structure unstructured text
- `orbites-obsidian-markdown` — markdown reference - `orbites-obsidian-markdown` Obsidian markdown reference
See `references/orbitos-skills.md` for OrbitOS integration details. See `references/orbitos-skills.md` for detailed usage.
### Scripts ### Scripts

View File

@@ -0,0 +1,61 @@
---
name: obsidian
description: Read, search, create, and edit notes in the Obsidian vault.
platforms: [linux, macos, windows]
---
# Obsidian Vault
Use this skill for filesystem-first Obsidian vault work: reading notes, listing notes, searching note files, creating notes, appending content, and adding wikilinks.
## Vault path
Use a known or resolved vault path before calling file tools.
The documented vault-path convention is the `OBSIDIAN_VAULT_PATH` environment variable, for example from `${HERMES_HOME:-~/.hermes}/.env`. If it is unset, use `~/Documents/Obsidian Vault`.
File tools do not expand shell variables. Do not pass paths containing `$OBSIDIAN_VAULT_PATH` to `read_file`, `write_file`, `patch`, or `search_files`; resolve the vault path first and pass a concrete absolute path. Vault paths may contain spaces, which is another reason to prefer file tools over shell commands.
If the vault path is unknown, `terminal` is acceptable for resolving `OBSIDIAN_VAULT_PATH` or checking whether the fallback path exists. Once the path is known, switch back to file tools.
## Read a note
Use `read_file` with the resolved absolute path to the note. Prefer this over `cat` because it provides line numbers and pagination.
## List notes
Use `search_files` with `target: "files"` and the resolved vault path. Prefer this over `find` or `ls`.
- To list all markdown notes, use `pattern: "*.md"` under the vault path.
- To list a subfolder, search under that subfolder's absolute path.
## Search
Use `search_files` for both filename and content searches. Prefer this over `grep`, `find`, or `ls`.
- For filenames, use `search_files` with `target: "files"` and a filename `pattern`.
- For note contents, use `search_files` with `target: "content"`, the content regex as `pattern`, and `file_glob: "*.md"` when you want to restrict matches to markdown notes.
## Create a note
Use `write_file` with the resolved absolute path and the full markdown content. Prefer this over shell heredocs or `echo` because it avoids shell quoting issues and returns structured results.
## Append to a note
Prefer a native file-tool workflow when it is not awkward:
- Read the target note with `read_file`.
- Use `patch` for an anchored append when there is stable context, such as adding a section after an existing heading or appending before a known trailing block.
- Use `write_file` when rewriting the whole note is clearer than constructing a fragile patch.
For an anchored append with `patch`, replace the anchor with the anchor plus the new content.
For a simple append with no stable context, `terminal` is acceptable if it is the clearest safe option.
## Targeted edits
Use `patch` for focused note changes when the current content gives you stable context. Prefer this over shell text rewriting.
## Wikilinks
Obsidian links notes with `[[Note Name]]` syntax. When creating notes, use these to link related content.

View File

@@ -0,0 +1,61 @@
---
name: orbites-obsidian-markdown
description: Obsidian Flavored Markdown reference — wikilinks, callouts, embeds, frontmatter, mermaid. Use when working with Obsidian vault files or user asks about wikilinks/callouts/embeds.
---
# OrbitOS: Obsidian Markdown Reference
Obsidian uses CommonMark + GitHub Flavored Markdown + Obsidian extensions (wikilinks, callouts, embeds).
## Internal Links (Wikilinks)
```markdown
[[Note Name]]
[[Note Name|Display Text]]
[[Note Name#Heading]]
[[Note Name#^block-id]]
![[Note Name]] # Embed entire note
![[Note Name#Section]] # Embed section
```
## Callouts
```markdown
> [!note] / [!info] / [!tip] / [!warning] / [!danger]
> [!faq]- Collapsed by default
> [!faq]+ Expanded by default
```
## Properties (Frontmatter)
```yaml
---
title: My Note
date: 2024-01-15
tags: [project, important]
aliases: [My Note, Alt Name]
status: in-progress
due: 2024-02-01T14:30:00
---
```
## Embeds
```markdown
![[image.png|300]] # Image with width
![[audio.mp3]] # Audio
![[document.pdf#page=3]] # PDF
```
## Other
- **Highlight**: `==text==`
- **Comments**: `%%hidden text%%`
- **Math**: `$e^{i\pi} + 1 = 0$`
- **Mermaid**: ```` ```mermaid ```` ````
## Critical DO NOT
- **No empty line after frontmatter** `---` (becomes visible in body)
- Frontmatter MUST be at line 1
- **NO duplicate keys** in frontmatter
- Use array syntax for tags: `tags: [tag1, tag2]`

View File

@@ -0,0 +1,55 @@
---
name: orbites-parse-knowledge
description: Take unstructured text and parse it into structured OrbitOS vault content — research notes + wiki concepts. Use when user says 'parse knowledge', 'organize this', 'structure text', 'จัดระเบียบ', 'parse this'.
---
# OrbitOS: Parse Knowledge — Structure Unstructured Text
You are a Vault Agent that ingests unstructured text and organizes it into the OrbitOS vault.
## Workflow
### 1. ANALYZE
- Identify the primary **Area** (SoftwareEngineering, Finance, Health, Writing, etc.)
- Create a slug for the main **Topic** (e.g., `ReactStatePatterns`)
- Extract **Atomic Concepts** that deserve their own wiki entry (e.g., `Redux`, `ContextAPI`)
### 2. GENERATE FILES
#### A. Main Research Note
- Path: `30_Research/<Area>/<Topic>/<Topic>.md`
- Frontmatter:
```yaml
---
created: YYYY-MM-DD
type: reference
area: "[[Area]]"
tags: [status/refactored]
---
```
- Content: Modular rewrite of the input text
- Replace specific terms with wikilinks `[[ConceptName]]`
#### B. Atomic Wiki Notes
- Path: `40_Wiki/<Category>/<ConceptName>.md`
- Frontmatter:
```yaml
---
area:
tags: []
created: YYYY-MM-DD
---
```
- Content: A concise, timeless definition of the concept
- Use format:
```markdown
# [Concept Name]
## Definition
[Clear definition]
## Key Points
- [Main characteristic]
## Related Concepts
- [[Related Concept 1]]
```

View File

@@ -0,0 +1,109 @@
---
name: orbites-research
description: Deep research workflow for OrbitOS — investigate a topic, create main research note, extract atomic wiki concepts. Use when user says 'research [topic]', 'deep dive', 'study', 'เรียนรู้', 'วิจัย'.
---
# OrbitOS: Research — Deep Dive
You are the Research Coordinator for OrbitOS. Investigate topics and create structured knowledge using a two-agent workflow.
## Input
The user provides:
- A topic (e.g., "React Server Components", "Consistent Hashing")
- Optional: Specific questions or goals
- Optional: Related project context
## Phase 1: Plan (Delegate to Subagent)
Spawn planning subagent:
```python
context = f"""
Create research plan for: [topic + user context]
1. Identify context:
- Check if relates to active project in 20_Project/
- Determine relevant Area (SoftwareEngineering, Finance, Health, etc.)
- Search 30_Research/ and 40_Wiki/ for existing content (avoid duplication)
2. Scan 99_System/Prompts/ for relevant expertise persona
3. Create plan at 90_Plans/Plan_YYYY-MM-DD_Research_<Topic>.md:
# Research Plan: [Topic]
## Research Objective
[What user will understand]
## Context Found
- Related Area: [Area]
- Existing notes: [list or 'None found']
- Related project: [project or N/A]
## Research Strategy
[ ] Find official docs
[ ] Find practical examples
[ ] Identify key concepts for Wiki
[ ] Find common pitfalls
## Output Structure
- Main note: 30_Research/<Area>/<Topic>/<Topic>.md
- Atomic concepts: 40_Wiki/<Category>/<ConceptName>.md
- Examples: 30_Research/<Area>/<Topic>/examples/ (if needed)
4. Return the plan file path.
"""
delegate_task(goal="Create research plan", context=context, toolsets=["web", "file"])
```
After planning agent returns, ask user: "Research plan at `[path]`. Review and confirm?"
## Phase 2: Execute (After User Confirmation)
Spawn execution subagent:
```python
context = f"""
Execute research plan at: 90_Plans/Plan_YYYY-MM-DD_Research_<Topic>.md
1. Read the plan file
2. Conduct research:
- Use web_search and web_extract for current information
- Gather practical examples
- Identify atomic concepts to extract
3. Create main research note at path from plan:
- Sections: Overview, Key Concepts (with [[wikilinks]]), How It Works, Examples, Best Practices, Common Pitfalls, See Also, Resources
4. Create atomic wiki notes: 40_Wiki/<Category>/<Concept>.md
- Keep concise (1-3 paragraphs)
- Include 'See Also' section
5. Create examples folder: 30_Research/<Area>/<Topic>/examples/ if needed
6. Link in today's daily note: 10_Daily/YYYY-MM-DD.md
7. Archive plan to 90_Plans/Archives/
Main research frontmatter:
---
type: reference
created: YYYY-MM-DD
area: "[[AreaName]]"
tags: [research, topic-tags]
status: complete
---
Wiki note frontmatter:
---
area:
tags: []
created: YYYY-MM-DD
---
"""
delegate_task(goal="Execute research plan", context=context, toolsets=["web", "terminal", "file"])
```
Report back with:
- **Created:** main note, wiki concepts, examples
- **Key Takeaways:** 3 main insights
- **Next Steps:** suggested follow-ups
## Edge Cases
- **Topic too broad:** Break into sub-topics
- **Topic already exists:** Update existing note, don't duplicate
- **Hands-on topic:** Ensure examples/ folder with working code