@jakkrichm/create-nexus-devflow 2.0.1 → 2.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/template/.agents/skills/9arm-skills/README.md +3 -3
- package/template/.agents/skills/intelligent-routing/SKILL.md +1 -1
- package/template/.claude/skills/9arm-skills/README.md +3 -3
- package/template/.claude/skills/intelligent-routing/SKILL.md +1 -1
- package/template/.nexus/nexus-devflow.json +1 -1
- package/template/AGENTS.md +3 -3
- package/template/devflow/context/project_index.json +108 -0
- package/template/.agents/skills/check-for-updates/SKILL.md +0 -117
- package/template/.agents/skills/devflow-concept-intake/SKILL.md +0 -150
- package/template/.agents/skills/devflow-concept-intake/agents/openai.yaml +0 -4
- package/template/.agents/skills/devflow-concept-intake/references/adoption-proposal-template.md +0 -60
- package/template/.agents/skills/devflow-concept-intake/references/concept-report-template.md +0 -47
- package/template/.agents/skills/devflow-concept-intake/references/upstream-tracking-template.md +0 -51
- package/template/.agents/skills/devflow-wiki/SKILL.md +0 -75
- package/template/.agents/skills/english-to-thai-translator/SKILL.md +0 -125
- package/template/.agents/skills/obsidian-bases/SKILL.md +0 -506
- package/template/.agents/skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md +0 -173
- package/template/.agents/skills/obsidian-cli/SKILL.md +0 -115
- package/template/.agents/skills/obsidian-clipper-template-creator/SKILL.md +0 -73
- package/template/.agents/skills/obsidian-clipper-template-creator/assets/clipping-template.json +0 -51
- package/template/.agents/skills/obsidian-clipper-template-creator/assets/recipe-template.json +0 -48
- package/template/.agents/skills/obsidian-clipper-template-creator/references/analysis-workflow.md +0 -79
- package/template/.agents/skills/obsidian-clipper-template-creator/references/bases-workflow.md +0 -44
- package/template/.agents/skills/obsidian-clipper-template-creator/references/filters.md +0 -51
- package/template/.agents/skills/obsidian-clipper-template-creator/references/json-schema.md +0 -77
- package/template/.agents/skills/obsidian-clipper-template-creator/references/logic.md +0 -67
- package/template/.agents/skills/obsidian-clipper-template-creator/references/variables.md +0 -64
- package/template/.agents/skills/obsidian-markdown/SKILL.md +0 -205
- package/template/.agents/skills/obsidian-markdown/references/CALLOUTS.md +0 -58
- package/template/.agents/skills/obsidian-markdown/references/EMBEDS.md +0 -63
- package/template/.agents/skills/obsidian-markdown/references/PROPERTIES.md +0 -61
- package/template/.agents/skills/prompt-addons/SKILL.md +0 -99
- package/template/.agents/skills/prp-dev-fastapi/SKILL.md +0 -114
- package/template/.agents/skills/prp-dev-multiplatform/SKILL.md +0 -36
- package/template/.agents/skills/prp-dev-odoo/SKILL.md +0 -71
- package/template/.agents/skills/prp-dev-php/SKILL.md +0 -63
- package/template/.agents/skills/prp-sa-ba/SKILL.md +0 -52
- package/template/.agents/skills/red-team-tactics/SKILL.md +0 -199
- package/template/.agents/skills/writing-great-skills/SKILL.md +0 -65
- package/template/.claude/skills/check-for-updates/SKILL.md +0 -117
- package/template/.claude/skills/devflow-concept-intake/SKILL.md +0 -150
- package/template/.claude/skills/devflow-concept-intake/agents/openai.yaml +0 -4
- package/template/.claude/skills/devflow-concept-intake/references/adoption-proposal-template.md +0 -60
- package/template/.claude/skills/devflow-concept-intake/references/concept-report-template.md +0 -47
- package/template/.claude/skills/devflow-concept-intake/references/upstream-tracking-template.md +0 -51
- package/template/.claude/skills/devflow-wiki/SKILL.md +0 -75
- package/template/.claude/skills/english-to-thai-translator/SKILL.md +0 -125
- package/template/.claude/skills/obsidian-bases/SKILL.md +0 -506
- package/template/.claude/skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md +0 -173
- package/template/.claude/skills/obsidian-cli/SKILL.md +0 -115
- package/template/.claude/skills/obsidian-clipper-template-creator/SKILL.md +0 -73
- package/template/.claude/skills/obsidian-clipper-template-creator/assets/clipping-template.json +0 -51
- package/template/.claude/skills/obsidian-clipper-template-creator/assets/recipe-template.json +0 -48
- package/template/.claude/skills/obsidian-clipper-template-creator/references/analysis-workflow.md +0 -79
- package/template/.claude/skills/obsidian-clipper-template-creator/references/bases-workflow.md +0 -44
- package/template/.claude/skills/obsidian-clipper-template-creator/references/filters.md +0 -51
- package/template/.claude/skills/obsidian-clipper-template-creator/references/json-schema.md +0 -77
- package/template/.claude/skills/obsidian-clipper-template-creator/references/logic.md +0 -67
- package/template/.claude/skills/obsidian-clipper-template-creator/references/variables.md +0 -64
- package/template/.claude/skills/obsidian-markdown/SKILL.md +0 -205
- package/template/.claude/skills/obsidian-markdown/references/CALLOUTS.md +0 -58
- package/template/.claude/skills/obsidian-markdown/references/EMBEDS.md +0 -63
- package/template/.claude/skills/obsidian-markdown/references/PROPERTIES.md +0 -61
- package/template/.claude/skills/prompt-addons/SKILL.md +0 -99
- package/template/.claude/skills/prp-dev-fastapi/SKILL.md +0 -114
- package/template/.claude/skills/prp-dev-multiplatform/SKILL.md +0 -36
- package/template/.claude/skills/prp-dev-odoo/SKILL.md +0 -71
- package/template/.claude/skills/prp-dev-php/SKILL.md +0 -63
- package/template/.claude/skills/prp-sa-ba/SKILL.md +0 -52
- package/template/.claude/skills/red-team-tactics/SKILL.md +0 -199
- package/template/.claude/skills/writing-great-skills/SKILL.md +0 -65
|
@@ -1,75 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow-wiki
|
|
3
|
-
description: Use when creating, updating, linting, querying, or deciding whether to ingest Nexus-DevFlow framework or project wiki knowledge under devflow/wiki.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# DevFlow Wiki
|
|
7
|
-
|
|
8
|
-
Use DevFlow Wiki to compile reusable knowledge from source artifacts into small, source-backed Markdown pages.
|
|
9
|
-
|
|
10
|
-
## Core Rules
|
|
11
|
-
|
|
12
|
-
- Treat wiki pages as compiled knowledge, not source truth.
|
|
13
|
-
- Keep `framework` and `project` namespaces separate.
|
|
14
|
-
- Include `## Sources` on every page.
|
|
15
|
-
- Use `_drafts/` for generated or unreviewed project pages.
|
|
16
|
-
- Prefer one focused page over broad rewrites.
|
|
17
|
-
- Do not ingest noisy logs, unverified hypotheses, or routine edits with no reusable lesson.
|
|
18
|
-
|
|
19
|
-
## Namespace Decision
|
|
20
|
-
|
|
21
|
-
| Scope | Use For | Path |
|
|
22
|
-
| :--- | :--- | :--- |
|
|
23
|
-
| `framework` | DevFlow workflows, agents, commands, install behavior, output contracts, token/context rules | `devflow/wiki/framework/` |
|
|
24
|
-
| `project` | Target project architecture, domain concepts, decisions, patterns, gotchas, task lessons | `devflow/wiki/project/` |
|
|
25
|
-
|
|
26
|
-
Promote project pages to framework only when the lesson applies beyond one project.
|
|
27
|
-
|
|
28
|
-
## Commands
|
|
29
|
-
|
|
30
|
-
Initialize and maintain wiki pages through the documented markdown structure under `devflow/wiki/`. Do not rely on the retired PRP runtime for wiki commands.
|
|
31
|
-
|
|
32
|
-
Use `Wiki {scope} ingest {source}` for workflow-level ingestion and route reporting.
|
|
33
|
-
|
|
34
|
-
## Project Wiki Contract
|
|
35
|
-
|
|
36
|
-
Every project wiki uses:
|
|
37
|
-
|
|
38
|
-
```text
|
|
39
|
-
devflow/wiki/project/
|
|
40
|
-
|-- index.md
|
|
41
|
-
|-- architecture/
|
|
42
|
-
|-- decisions/
|
|
43
|
-
|-- domain/
|
|
44
|
-
|-- gotchas/
|
|
45
|
-
|-- patterns/
|
|
46
|
-
|-- tasks/
|
|
47
|
-
|-- token-context/
|
|
48
|
-
`-- _drafts/
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
Each published page should follow `.agent/resources/schemas/wiki_page.template.md`.
|
|
52
|
-
|
|
53
|
-
## Ingest Heuristics
|
|
54
|
-
|
|
55
|
-
Ingest when the source contains reusable knowledge:
|
|
56
|
-
|
|
57
|
-
- verified QA evidence
|
|
58
|
-
- confirmed root cause and prevention
|
|
59
|
-
- durable project decision
|
|
60
|
-
- stable architecture or domain concept
|
|
61
|
-
- repeated gotcha or risk pattern
|
|
62
|
-
- context/token optimization lesson
|
|
63
|
-
|
|
64
|
-
Skip ingest when the source is one-off, unverified, noisy, or already represented in a focused page.
|
|
65
|
-
|
|
66
|
-
## Output Expectation
|
|
67
|
-
|
|
68
|
-
Always report:
|
|
69
|
-
|
|
70
|
-
- pages created or updated
|
|
71
|
-
- source artifacts used
|
|
72
|
-
- lint result or remaining issue
|
|
73
|
-
- next workflow recommendation
|
|
74
|
-
- wiki update recommendation
|
|
75
|
-
|
|
@@ -1,125 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: english-to-thai-translator
|
|
3
|
-
description: English to Thai translation with context awareness for software development documentation and user interfaces.
|
|
4
|
-
allowed-tools: Read, Grep, Glob
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# 🇹🇭 English to Thai Translation Skill
|
|
8
|
-
|
|
9
|
-
This skill enables AI agents to translate English text to Thai while maintaining technical accuracy and contextual meaning. It's designed specifically for software development environments where precise terminology is crucial.
|
|
10
|
-
|
|
11
|
-
## 🎯 When to Use This Skill
|
|
12
|
-
|
|
13
|
-
- Translating technical documentation from English to Thai
|
|
14
|
-
- Localizing user interface elements (buttons, labels, messages)
|
|
15
|
-
- Converting code comments and developer notes
|
|
16
|
-
- Creating multilingual project specifications
|
|
17
|
-
- Translating API documentation or technical requirements
|
|
18
|
-
|
|
19
|
-
## 📝 Translation Guidelines
|
|
20
|
-
|
|
21
|
-
### Technical Terminology
|
|
22
|
-
- Maintain consistency with existing project terminology
|
|
23
|
-
- Use appropriate Thai technical terms for software concepts
|
|
24
|
-
- Preserve acronyms and abbreviations when they're standard in Thai context
|
|
25
|
-
- When no direct Thai equivalent exists, use transliteration + explanation
|
|
26
|
-
|
|
27
|
-
### Style and Tone
|
|
28
|
-
- Keep formal tone for documentation and specifications
|
|
29
|
-
- Use conversational tone for user-facing interfaces
|
|
30
|
-
- Maintain consistent terminology throughout the document
|
|
31
|
-
- Ensure translations are culturally appropriate for Thai audience
|
|
32
|
-
|
|
33
|
-
### Special Considerations
|
|
34
|
-
- **Code Comments**: Preserve code structure, translate only comments
|
|
35
|
-
- **API Documentation**: Maintain parameter names and technical descriptions
|
|
36
|
-
- **UI Text**: Follow Thai text direction (left-to-right) and spacing conventions
|
|
37
|
-
- **Numbers and Dates**: Use Thai number formats and date conventions
|
|
38
|
-
|
|
39
|
-
## 🛠️ Usage Examples
|
|
40
|
-
|
|
41
|
-
### Example 1: Translating Documentation
|
|
42
|
-
```
|
|
43
|
-
Original English:
|
|
44
|
-
"Configure the database connection parameters in the config file."
|
|
45
|
-
|
|
46
|
-
Thai Translation:
|
|
47
|
-
"ตั้งค่าพารามิเตอร์การเชื่อมต่อฐานข้อมูลในไฟล์กำหนดค่า"
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
### Example 2: Translating UI Elements
|
|
51
|
-
```
|
|
52
|
-
Original English:
|
|
53
|
-
"Save Changes"
|
|
54
|
-
|
|
55
|
-
Thai Translation:
|
|
56
|
-
"บันทึกการเปลี่ยนแปลง"
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
### Example 3: Translating Technical Specifications
|
|
60
|
-
```
|
|
61
|
-
Original English:
|
|
62
|
-
"The system shall validate user input before processing."
|
|
63
|
-
|
|
64
|
-
Thai Translation:
|
|
65
|
-
"ระบบจะต้องตรวจสอบข้อมูลที่ผู้ใช้ป้อนก่อนประมวลผล"
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
## 📚 Best Practices
|
|
69
|
-
|
|
70
|
-
### DO ✅
|
|
71
|
-
- Use proper Thai punctuation and spacing conventions
|
|
72
|
-
- Maintain technical accuracy over literal translation
|
|
73
|
-
- Ensure consistency with existing Thai terminology in the project
|
|
74
|
-
- Preserve code formatting when translating comments
|
|
75
|
-
|
|
76
|
-
### DON'T ❌
|
|
77
|
-
- Don't translate technical terms without context consideration
|
|
78
|
-
- Don't ignore cultural appropriateness for Thai audience
|
|
79
|
-
- Don't break existing code structure or syntax
|
|
80
|
-
- Don't create overly literal translations that lose meaning
|
|
81
|
-
|
|
82
|
-
## 🧪 Quality Checks
|
|
83
|
-
|
|
84
|
-
Before completing translation tasks, verify:
|
|
85
|
-
1. Technical accuracy of translated terminology
|
|
86
|
-
2. Cultural appropriateness of the translation
|
|
87
|
-
3. Consistency with project's existing Thai documentation
|
|
88
|
-
4. Proper formatting and spacing for UI elements
|
|
89
|
-
5. No broken links or references in translated content
|
|
90
|
-
|
|
91
|
-
## 🔄 Integration with PRPs Framework
|
|
92
|
-
|
|
93
|
-
This skill works within the DevFlow 2.0 workflow:
|
|
94
|
-
1. During `/10-Define` or `/20-Spec`, it can help create multilingual specifications
|
|
95
|
-
2. In `/30-Plan`, it helps explain technical requirements in Thai
|
|
96
|
-
3. During `/40-Implement`, it translates comments and documentation when needed
|
|
97
|
-
4. In `/50-Verify` or `/60-Report`, it helps ensure translated content remains clear and correct
|
|
98
|
-
|
|
99
|
-
## 📁 File Structure
|
|
100
|
-
|
|
101
|
-
The skill is designed to work with:
|
|
102
|
-
- Documentation files (`.md`, `.txt`)
|
|
103
|
-
- Code comments (`.js`, `.ts`, `.py`, `.java`)
|
|
104
|
-
- Configuration files that contain text to be translated
|
|
105
|
-
- User interface text resources
|
|
106
|
-
|
|
107
|
-
## ⚠️ Limitations
|
|
108
|
-
|
|
109
|
-
This skill provides general translation capabilities but may require human review for:
|
|
110
|
-
- Highly specialized technical domains
|
|
111
|
-
- Cultural nuances and idioms
|
|
112
|
-
- Creative content requiring artistic interpretation
|
|
113
|
-
- Legal or regulatory documents requiring official translations
|
|
114
|
-
|
|
115
|
-
## 📋 Language Constraints
|
|
116
|
-
|
|
117
|
-
This skill is strictly limited to translating between English and Thai languages only. All output must be exclusively in either English or Thai, with no inclusion of:
|
|
118
|
-
- Chinese (or any other language)
|
|
119
|
-
- Mixed language content
|
|
120
|
-
- Transliterations that include non-Thai characters
|
|
121
|
-
- Any foreign language elements
|
|
122
|
-
|
|
123
|
-
The translation must maintain pure English-to-Thai conversion without introducing additional languages or mixed scripts.
|
|
124
|
-
|
|
125
|
-
*Generated by Nexus-DevFlow Specialist*
|
|
@@ -1,506 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: obsidian-bases
|
|
3
|
-
description: Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, filters, or formulas in Obsidian.
|
|
4
|
-
risk: unknown
|
|
5
|
-
source: "https://github.com/kepano/obsidian-skills"
|
|
6
|
-
date_added: "2026-03-21"
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Obsidian Bases Skill
|
|
10
|
-
|
|
11
|
-
## When to Use
|
|
12
|
-
|
|
13
|
-
- Use when creating or editing `.base` files in Obsidian.
|
|
14
|
-
- Use for database-like note views with filters, formulas, summaries, or cards/tables.
|
|
15
|
-
- Use when the user asks about Obsidian Bases specifically.
|
|
16
|
-
|
|
17
|
-
## Workflow
|
|
18
|
-
|
|
19
|
-
1. **Create the file**: Create a `.base` file in the vault with valid YAML content
|
|
20
|
-
2. **Define scope**: Add `filters` to select which notes appear (by tag, folder, property, or date)
|
|
21
|
-
3. **Add formulas** (optional): Define computed properties in the `formulas` section
|
|
22
|
-
4. **Configure views**: Add one or more views (`table`, `cards`, `list`, or `map`) with `order` specifying which properties to display
|
|
23
|
-
5. **Validate**: Verify the file is valid YAML with no syntax errors. Check that all referenced properties and formulas exist. Common issues: unquoted strings containing special YAML characters, mismatched quotes in formula expressions, referencing `formula.X` without defining `X` in `formulas`
|
|
24
|
-
6. **Test in Obsidian**: Open the `.base` file in Obsidian to confirm the view renders correctly. If it shows a YAML error, check quoting rules below
|
|
25
|
-
|
|
26
|
-
## Schema
|
|
27
|
-
|
|
28
|
-
Base files use the `.base` extension and contain valid YAML.
|
|
29
|
-
|
|
30
|
-
```yaml
|
|
31
|
-
# Global filters apply to ALL views in the base
|
|
32
|
-
filters:
|
|
33
|
-
# Can be a single filter string
|
|
34
|
-
# OR a recursive filter object with and/or/not
|
|
35
|
-
and: []
|
|
36
|
-
or: []
|
|
37
|
-
not: []
|
|
38
|
-
|
|
39
|
-
# Define formula properties that can be used across all views
|
|
40
|
-
formulas:
|
|
41
|
-
formula_name: 'expression'
|
|
42
|
-
|
|
43
|
-
# Configure display names and settings for properties
|
|
44
|
-
properties:
|
|
45
|
-
property_name:
|
|
46
|
-
displayName: "Display Name"
|
|
47
|
-
formula.formula_name:
|
|
48
|
-
displayName: "Formula Display Name"
|
|
49
|
-
file.ext:
|
|
50
|
-
displayName: "Extension"
|
|
51
|
-
|
|
52
|
-
# Define custom summary formulas
|
|
53
|
-
summaries:
|
|
54
|
-
custom_summary_name: 'values.mean().round(3)'
|
|
55
|
-
|
|
56
|
-
# Define one or more views
|
|
57
|
-
views:
|
|
58
|
-
- type: table | cards | list | map
|
|
59
|
-
name: "View Name"
|
|
60
|
-
limit: 10 # Optional: limit results
|
|
61
|
-
groupBy: # Optional: group results
|
|
62
|
-
property: property_name
|
|
63
|
-
direction: ASC | DESC
|
|
64
|
-
filters: # View-specific filters
|
|
65
|
-
and: []
|
|
66
|
-
order: # Properties to display in order
|
|
67
|
-
- file.name
|
|
68
|
-
- property_name
|
|
69
|
-
- formula.formula_name
|
|
70
|
-
summaries: # Map properties to summary formulas
|
|
71
|
-
property_name: Average
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
## Filter Syntax
|
|
75
|
-
|
|
76
|
-
Filters narrow down results. They can be applied globally or per-view.
|
|
77
|
-
|
|
78
|
-
### Filter Structure
|
|
79
|
-
|
|
80
|
-
```yaml
|
|
81
|
-
# Single filter
|
|
82
|
-
filters: 'status == "done"'
|
|
83
|
-
|
|
84
|
-
# AND - all conditions must be true
|
|
85
|
-
filters:
|
|
86
|
-
and:
|
|
87
|
-
- 'status == "done"'
|
|
88
|
-
- 'priority > 3'
|
|
89
|
-
|
|
90
|
-
# OR - any condition can be true
|
|
91
|
-
filters:
|
|
92
|
-
or:
|
|
93
|
-
- 'file.hasTag("book")'
|
|
94
|
-
- 'file.hasTag("article")'
|
|
95
|
-
|
|
96
|
-
# NOT - exclude matching items
|
|
97
|
-
filters:
|
|
98
|
-
not:
|
|
99
|
-
- 'file.hasTag("archived")'
|
|
100
|
-
|
|
101
|
-
# Nested filters
|
|
102
|
-
filters:
|
|
103
|
-
or:
|
|
104
|
-
- file.hasTag("tag")
|
|
105
|
-
- and:
|
|
106
|
-
- file.hasTag("book")
|
|
107
|
-
- file.hasLink("Textbook")
|
|
108
|
-
- not:
|
|
109
|
-
- file.hasTag("book")
|
|
110
|
-
- file.inFolder("Required Reading")
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
### Filter Operators
|
|
114
|
-
|
|
115
|
-
| Operator | Description |
|
|
116
|
-
|----------|-------------|
|
|
117
|
-
| `==` | equals |
|
|
118
|
-
| `!=` | not equal |
|
|
119
|
-
| `>` | greater than |
|
|
120
|
-
| `<` | less than |
|
|
121
|
-
| `>=` | greater than or equal |
|
|
122
|
-
| `<=` | less than or equal |
|
|
123
|
-
| `&&` | logical and |
|
|
124
|
-
| `\|\|` | logical or |
|
|
125
|
-
| <code>!</code> | logical not |
|
|
126
|
-
|
|
127
|
-
## Properties
|
|
128
|
-
|
|
129
|
-
### Three Types of Properties
|
|
130
|
-
|
|
131
|
-
1. **Note properties** - From frontmatter: `note.author` or just `author`
|
|
132
|
-
2. **File properties** - File metadata: `file.name`, `file.mtime`, etc.
|
|
133
|
-
3. **Formula properties** - Computed values: `formula.my_formula`
|
|
134
|
-
|
|
135
|
-
### File Properties Reference
|
|
136
|
-
|
|
137
|
-
| Property | Type | Description |
|
|
138
|
-
|----------|------|-------------|
|
|
139
|
-
| `file.name` | String | File name |
|
|
140
|
-
| `file.basename` | String | File name without extension |
|
|
141
|
-
| `file.path` | String | Full path to file |
|
|
142
|
-
| `file.folder` | String | Parent folder path |
|
|
143
|
-
| `file.ext` | String | File extension |
|
|
144
|
-
| `file.size` | Number | File size in bytes |
|
|
145
|
-
| `file.ctime` | Date | Created time |
|
|
146
|
-
| `file.mtime` | Date | Modified time |
|
|
147
|
-
| `file.tags` | List | All tags in file |
|
|
148
|
-
| `file.links` | List | Internal links in file |
|
|
149
|
-
| `file.backlinks` | List | Files linking to this file |
|
|
150
|
-
| `file.embeds` | List | Embeds in the note |
|
|
151
|
-
| `file.properties` | Object | All frontmatter properties |
|
|
152
|
-
|
|
153
|
-
### The `this` Keyword
|
|
154
|
-
|
|
155
|
-
- In main content area: refers to the base file itself
|
|
156
|
-
- When embedded: refers to the embedding file
|
|
157
|
-
- In sidebar: refers to the active file in main content
|
|
158
|
-
|
|
159
|
-
## Formula Syntax
|
|
160
|
-
|
|
161
|
-
Formulas compute values from properties. Defined in the `formulas` section.
|
|
162
|
-
|
|
163
|
-
```yaml
|
|
164
|
-
formulas:
|
|
165
|
-
# Simple arithmetic
|
|
166
|
-
total: "price * quantity"
|
|
167
|
-
|
|
168
|
-
# Conditional logic
|
|
169
|
-
status_icon: 'if(done, "✅", "⏳")'
|
|
170
|
-
|
|
171
|
-
# String formatting
|
|
172
|
-
formatted_price: 'if(price, price.toFixed(2) + " dollars")'
|
|
173
|
-
|
|
174
|
-
# Date formatting
|
|
175
|
-
created: 'file.ctime.format("YYYY-MM-DD")'
|
|
176
|
-
|
|
177
|
-
# Calculate days since created (use .days for Duration)
|
|
178
|
-
days_old: '(now() - file.ctime).days'
|
|
179
|
-
|
|
180
|
-
# Calculate days until due date
|
|
181
|
-
days_until_due: 'if(due_date, (date(due_date) - today()).days, "")'
|
|
182
|
-
```
|
|
183
|
-
|
|
184
|
-
## Key Functions
|
|
185
|
-
|
|
186
|
-
Most commonly used functions. For the complete reference of all types (Date, String, Number, List, File, Link, Object, RegExp), see [FUNCTIONS_REFERENCE.md](references/FUNCTIONS_REFERENCE.md).
|
|
187
|
-
|
|
188
|
-
| Function | Signature | Description |
|
|
189
|
-
|----------|-----------|-------------|
|
|
190
|
-
| `date()` | `date(string): date` | Parse string to date (`YYYY-MM-DD HH:mm:ss`) |
|
|
191
|
-
| `now()` | `now(): date` | Current date and time |
|
|
192
|
-
| `today()` | `today(): date` | Current date (time = 00:00:00) |
|
|
193
|
-
| `if()` | `if(condition, trueResult, falseResult?)` | Conditional |
|
|
194
|
-
| `duration()` | `duration(string): duration` | Parse duration string |
|
|
195
|
-
| `file()` | `file(path): file` | Get file object |
|
|
196
|
-
| `link()` | `link(path, display?): Link` | Create a link |
|
|
197
|
-
|
|
198
|
-
### Duration Type
|
|
199
|
-
|
|
200
|
-
When subtracting two dates, the result is a **Duration** type (not a number).
|
|
201
|
-
|
|
202
|
-
**Duration Fields:** `duration.days`, `duration.hours`, `duration.minutes`, `duration.seconds`, `duration.milliseconds`
|
|
203
|
-
|
|
204
|
-
**IMPORTANT:** Duration does NOT support `.round()`, `.floor()`, `.ceil()` directly. Access a numeric field first (like `.days`), then apply number functions.
|
|
205
|
-
|
|
206
|
-
```yaml
|
|
207
|
-
# CORRECT: Calculate days between dates
|
|
208
|
-
"(date(due_date) - today()).days" # Returns number of days
|
|
209
|
-
"(now() - file.ctime).days" # Days since created
|
|
210
|
-
"(date(due_date) - today()).days.round(0)" # Rounded days
|
|
211
|
-
|
|
212
|
-
# WRONG - will cause error:
|
|
213
|
-
# "((date(due) - today()) / 86400000).round(0)" # Duration doesn't support division then round
|
|
214
|
-
```
|
|
215
|
-
|
|
216
|
-
### Date Arithmetic
|
|
217
|
-
|
|
218
|
-
```yaml
|
|
219
|
-
# Duration units: y/year/years, M/month/months, d/day/days,
|
|
220
|
-
# w/week/weeks, h/hour/hours, m/minute/minutes, s/second/seconds
|
|
221
|
-
"now() + \"1 day\"" # Tomorrow
|
|
222
|
-
"today() + \"7d\"" # A week from today
|
|
223
|
-
"now() - file.ctime" # Returns Duration
|
|
224
|
-
"(now() - file.ctime).days" # Get days as number
|
|
225
|
-
```
|
|
226
|
-
|
|
227
|
-
## View Types
|
|
228
|
-
|
|
229
|
-
### Table View
|
|
230
|
-
|
|
231
|
-
```yaml
|
|
232
|
-
views:
|
|
233
|
-
- type: table
|
|
234
|
-
name: "My Table"
|
|
235
|
-
order:
|
|
236
|
-
- file.name
|
|
237
|
-
- status
|
|
238
|
-
- due_date
|
|
239
|
-
summaries:
|
|
240
|
-
price: Sum
|
|
241
|
-
count: Average
|
|
242
|
-
```
|
|
243
|
-
|
|
244
|
-
### Cards View
|
|
245
|
-
|
|
246
|
-
```yaml
|
|
247
|
-
views:
|
|
248
|
-
- type: cards
|
|
249
|
-
name: "Gallery"
|
|
250
|
-
order:
|
|
251
|
-
- file.name
|
|
252
|
-
- cover_image
|
|
253
|
-
- description
|
|
254
|
-
```
|
|
255
|
-
|
|
256
|
-
### List View
|
|
257
|
-
|
|
258
|
-
```yaml
|
|
259
|
-
views:
|
|
260
|
-
- type: list
|
|
261
|
-
name: "Simple List"
|
|
262
|
-
order:
|
|
263
|
-
- file.name
|
|
264
|
-
- status
|
|
265
|
-
```
|
|
266
|
-
|
|
267
|
-
### Map View
|
|
268
|
-
|
|
269
|
-
Requires latitude/longitude properties and the Maps community plugin.
|
|
270
|
-
|
|
271
|
-
```yaml
|
|
272
|
-
views:
|
|
273
|
-
- type: map
|
|
274
|
-
name: "Locations"
|
|
275
|
-
# Map-specific settings for lat/lng properties
|
|
276
|
-
```
|
|
277
|
-
|
|
278
|
-
## Default Summary Formulas
|
|
279
|
-
|
|
280
|
-
| Name | Input Type | Description |
|
|
281
|
-
|------|------------|-------------|
|
|
282
|
-
| `Average` | Number | Mathematical mean |
|
|
283
|
-
| `Min` | Number | Smallest number |
|
|
284
|
-
| `Max` | Number | Largest number |
|
|
285
|
-
| `Sum` | Number | Sum of all numbers |
|
|
286
|
-
| `Range` | Number | Max - Min |
|
|
287
|
-
| `Median` | Number | Mathematical median |
|
|
288
|
-
| `Stddev` | Number | Standard deviation |
|
|
289
|
-
| `Earliest` | Date | Earliest date |
|
|
290
|
-
| `Latest` | Date | Latest date |
|
|
291
|
-
| `Range` | Date | Latest - Earliest |
|
|
292
|
-
| `Checked` | Boolean | Count of true values |
|
|
293
|
-
| `Unchecked` | Boolean | Count of false values |
|
|
294
|
-
| `Empty` | Any | Count of empty values |
|
|
295
|
-
| `Filled` | Any | Count of non-empty values |
|
|
296
|
-
| `Unique` | Any | Count of unique values |
|
|
297
|
-
|
|
298
|
-
## Complete Examples
|
|
299
|
-
|
|
300
|
-
### Task Tracker Base
|
|
301
|
-
|
|
302
|
-
```yaml
|
|
303
|
-
filters:
|
|
304
|
-
and:
|
|
305
|
-
- file.hasTag("task")
|
|
306
|
-
- 'file.ext == "md"'
|
|
307
|
-
|
|
308
|
-
formulas:
|
|
309
|
-
days_until_due: 'if(due, (date(due) - today()).days, "")'
|
|
310
|
-
is_overdue: 'if(due, date(due) < today() && status != "done", false)'
|
|
311
|
-
priority_label: 'if(priority == 1, "🔴 High", if(priority == 2, "🟡 Medium", "🟢 Low"))'
|
|
312
|
-
|
|
313
|
-
properties:
|
|
314
|
-
status:
|
|
315
|
-
displayName: Status
|
|
316
|
-
formula.days_until_due:
|
|
317
|
-
displayName: "Days Until Due"
|
|
318
|
-
formula.priority_label:
|
|
319
|
-
displayName: Priority
|
|
320
|
-
|
|
321
|
-
views:
|
|
322
|
-
- type: table
|
|
323
|
-
name: "Active Tasks"
|
|
324
|
-
filters:
|
|
325
|
-
and:
|
|
326
|
-
- 'status != "done"'
|
|
327
|
-
order:
|
|
328
|
-
- file.name
|
|
329
|
-
- status
|
|
330
|
-
- formula.priority_label
|
|
331
|
-
- due
|
|
332
|
-
- formula.days_until_due
|
|
333
|
-
groupBy:
|
|
334
|
-
property: status
|
|
335
|
-
direction: ASC
|
|
336
|
-
summaries:
|
|
337
|
-
formula.days_until_due: Average
|
|
338
|
-
|
|
339
|
-
- type: table
|
|
340
|
-
name: "Completed"
|
|
341
|
-
filters:
|
|
342
|
-
and:
|
|
343
|
-
- 'status == "done"'
|
|
344
|
-
order:
|
|
345
|
-
- file.name
|
|
346
|
-
- completed_date
|
|
347
|
-
```
|
|
348
|
-
|
|
349
|
-
### Reading List Base
|
|
350
|
-
|
|
351
|
-
```yaml
|
|
352
|
-
filters:
|
|
353
|
-
or:
|
|
354
|
-
- file.hasTag("book")
|
|
355
|
-
- file.hasTag("article")
|
|
356
|
-
|
|
357
|
-
formulas:
|
|
358
|
-
reading_time: 'if(pages, (pages * 2).toString() + " min", "")'
|
|
359
|
-
status_icon: 'if(status == "reading", "📖", if(status == "done", "✅", "📚"))'
|
|
360
|
-
year_read: 'if(finished_date, date(finished_date).year, "")'
|
|
361
|
-
|
|
362
|
-
properties:
|
|
363
|
-
author:
|
|
364
|
-
displayName: Author
|
|
365
|
-
formula.status_icon:
|
|
366
|
-
displayName: ""
|
|
367
|
-
formula.reading_time:
|
|
368
|
-
displayName: "Est. Time"
|
|
369
|
-
|
|
370
|
-
views:
|
|
371
|
-
- type: cards
|
|
372
|
-
name: "Library"
|
|
373
|
-
order:
|
|
374
|
-
- cover
|
|
375
|
-
- file.name
|
|
376
|
-
- author
|
|
377
|
-
- formula.status_icon
|
|
378
|
-
filters:
|
|
379
|
-
not:
|
|
380
|
-
- 'status == "dropped"'
|
|
381
|
-
|
|
382
|
-
- type: table
|
|
383
|
-
name: "Reading List"
|
|
384
|
-
filters:
|
|
385
|
-
and:
|
|
386
|
-
- 'status == "to-read"'
|
|
387
|
-
order:
|
|
388
|
-
- file.name
|
|
389
|
-
- author
|
|
390
|
-
- pages
|
|
391
|
-
- formula.reading_time
|
|
392
|
-
```
|
|
393
|
-
|
|
394
|
-
### Daily Notes Index
|
|
395
|
-
|
|
396
|
-
```yaml
|
|
397
|
-
filters:
|
|
398
|
-
and:
|
|
399
|
-
- file.inFolder("Daily Notes")
|
|
400
|
-
- '/^\d{4}-\d{2}-\d{2}$/.matches(file.basename)'
|
|
401
|
-
|
|
402
|
-
formulas:
|
|
403
|
-
word_estimate: '(file.size / 5).round(0)'
|
|
404
|
-
day_of_week: 'date(file.basename).format("dddd")'
|
|
405
|
-
|
|
406
|
-
properties:
|
|
407
|
-
formula.day_of_week:
|
|
408
|
-
displayName: "Day"
|
|
409
|
-
formula.word_estimate:
|
|
410
|
-
displayName: "~Words"
|
|
411
|
-
|
|
412
|
-
views:
|
|
413
|
-
- type: table
|
|
414
|
-
name: "Recent Notes"
|
|
415
|
-
limit: 30
|
|
416
|
-
order:
|
|
417
|
-
- file.name
|
|
418
|
-
- formula.day_of_week
|
|
419
|
-
- formula.word_estimate
|
|
420
|
-
- file.mtime
|
|
421
|
-
```
|
|
422
|
-
|
|
423
|
-
## Embedding Bases
|
|
424
|
-
|
|
425
|
-
Embed in Markdown files:
|
|
426
|
-
|
|
427
|
-
```markdown
|
|
428
|
-
![[MyBase.base]]
|
|
429
|
-
|
|
430
|
-
<!-- Specific view -->
|
|
431
|
-
![[MyBase.base#View Name]]
|
|
432
|
-
```
|
|
433
|
-
|
|
434
|
-
## YAML Quoting Rules
|
|
435
|
-
|
|
436
|
-
- Use single quotes for formulas containing double quotes: `'if(done, "Yes", "No")'`
|
|
437
|
-
- Use double quotes for simple strings: `"My View Name"`
|
|
438
|
-
- Escape nested quotes properly in complex expressions
|
|
439
|
-
|
|
440
|
-
## Troubleshooting
|
|
441
|
-
|
|
442
|
-
### YAML Syntax Errors
|
|
443
|
-
|
|
444
|
-
**Unquoted special characters**: Strings containing `:`, `{`, `}`, `[`, `]`, `,`, `&`, `*`, `#`, `?`, `|`, `-`, `<`, `>`, `=`, `!`, `%`, `@`, `` ` `` must be quoted.
|
|
445
|
-
|
|
446
|
-
```yaml
|
|
447
|
-
# WRONG - colon in unquoted string
|
|
448
|
-
displayName: Status: Active
|
|
449
|
-
|
|
450
|
-
# CORRECT
|
|
451
|
-
displayName: "Status: Active"
|
|
452
|
-
```
|
|
453
|
-
|
|
454
|
-
**Mismatched quotes in formulas**: When a formula contains double quotes, wrap the entire formula in single quotes.
|
|
455
|
-
|
|
456
|
-
```yaml
|
|
457
|
-
# WRONG - double quotes inside double quotes
|
|
458
|
-
formulas:
|
|
459
|
-
label: "if(done, "Yes", "No")"
|
|
460
|
-
|
|
461
|
-
# CORRECT - single quotes wrapping double quotes
|
|
462
|
-
formulas:
|
|
463
|
-
label: 'if(done, "Yes", "No")'
|
|
464
|
-
```
|
|
465
|
-
|
|
466
|
-
### Common Formula Errors
|
|
467
|
-
|
|
468
|
-
**Duration math without field access**: Subtracting dates returns a Duration, not a number. Always access `.days`, `.hours`, etc.
|
|
469
|
-
|
|
470
|
-
```yaml
|
|
471
|
-
# WRONG - Duration is not a number
|
|
472
|
-
"(now() - file.ctime).round(0)"
|
|
473
|
-
|
|
474
|
-
# CORRECT - access .days first, then round
|
|
475
|
-
"(now() - file.ctime).days.round(0)"
|
|
476
|
-
```
|
|
477
|
-
|
|
478
|
-
**Missing null checks**: Properties may not exist on all notes. Use `if()` to guard.
|
|
479
|
-
|
|
480
|
-
```yaml
|
|
481
|
-
# WRONG - crashes if due_date is empty
|
|
482
|
-
"(date(due_date) - today()).days"
|
|
483
|
-
|
|
484
|
-
# CORRECT - guard with if()
|
|
485
|
-
'if(due_date, (date(due_date) - today()).days, "")'
|
|
486
|
-
```
|
|
487
|
-
|
|
488
|
-
**Referencing undefined formulas**: Ensure every `formula.X` in `order` or `properties` has a matching entry in `formulas`.
|
|
489
|
-
|
|
490
|
-
```yaml
|
|
491
|
-
# This will fail silently if 'total' is not defined in formulas
|
|
492
|
-
order:
|
|
493
|
-
- formula.total
|
|
494
|
-
|
|
495
|
-
# Fix: define it
|
|
496
|
-
formulas:
|
|
497
|
-
total: "price * quantity"
|
|
498
|
-
```
|
|
499
|
-
|
|
500
|
-
## References
|
|
501
|
-
|
|
502
|
-
- [Bases Syntax](https://help.obsidian.md/bases/syntax)
|
|
503
|
-
- [Functions](https://help.obsidian.md/bases/functions)
|
|
504
|
-
- [Views](https://help.obsidian.md/bases/views)
|
|
505
|
-
- [Formulas](https://help.obsidian.md/formulas)
|
|
506
|
-
- [Complete Functions Reference](references/FUNCTIONS_REFERENCE.md)
|