obsidian-plugin-dev

Automates Obsidian plugin project scaffolding, TypeScript configuration, Esbuild bundling, and API usage patterns.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/fantay0312/fantayspec --skill obsidian-plugin-dev-fantay0312
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-plugin-dev
Source: https://github.com/fantay0312/fantayspec/tree/main/shared/skills/skills-all/obsidian-plugin-dev
Command: npx skills add https://github.com/fantay0312/fantayspec --skill obsidian-plugin-dev-fantay0312

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide helps developers accelerate Obsidian plugin development by providing a ready-to-use project skeleton, configuration templates, and practical API usage patterns, reducing setup time and avoiding common pitfalls.

Core Features & Use Cases

  • Starter project skeleton: manifest.json, main.ts, tsconfig.json, esbuild.config.mjs, and source folders.
  • Build and test workflow: npm scripts for development and production builds.
  • Obsidian API patterns: reading/writing vault files, frontmatter, commands, events, and UI components.
  • Troubleshooting and debugging guidance: common errors and debugging tips.
  • Use Case: Quickly scaffold a new plugin and integrate with the Obsidian API to implement a new feature.

Quick Start

Create a new Obsidian plugin project using the provided templates and run the development workflow to build and test.

Frequently Asked Questions about obsidian-plugin-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an Obsidian plugin development environment with TypeScript and esbuild?

To set up an Obsidian plugin development environment, use a starter project skeleton containing manifest.json, main.ts, tsconfig.json, and esbuild.config.mjs. This standardizes project scaffolding, TypeScript configuration, and esbuild bundling to accelerate initial setup.

What Obsidian API patterns are available for reading and writing vault files?

Obsidian API patterns for reading and writing vault files include operations for frontmatter, commands, events, and UI components. These templates provide practical implementation examples for integrating vault operations directly into your plugin's source code.

Can I use this workflow to scaffold a new Obsidian plugin project from scratch?

Yes, you can scaffold a new Obsidian plugin project from scratch using provided templates and npm scripts. The workflow generates necessary configuration files and source folders, enabling you to quickly integrate the Obsidian API to implement features.

What's the best way to configure esbuild for bundling an Obsidian plugin?

The best way to configure esbuild for bundling an Obsidian plugin is using the provided esbuild.config.mjs template. This ensures standardized build and test workflows alongside npm scripts for both development and production builds.

Why does my Obsidian plugin build fail during TypeScript compilation?

Obsidian plugin builds failing during TypeScript compilation often stem from misconfigured tsconfig.json or manifest.json files. The included troubleshooting and debugging guidance helps identify common errors, ensuring your TypeScript configuration aligns with Obsidian API requirements.

Do I need prior TypeScript experience to develop an Obsidian plugin using these templates?

Prior TypeScript experience is beneficial when developing an Obsidian plugin using these templates, as the workflow relies on TypeScript configuration and esbuild bundling. The provided starter skeleton standardizes setup but assumes foundational programming knowledge.