@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.
Files changed (72) hide show
  1. package/package.json +1 -1
  2. package/template/.agents/skills/9arm-skills/README.md +3 -3
  3. package/template/.agents/skills/intelligent-routing/SKILL.md +1 -1
  4. package/template/.claude/skills/9arm-skills/README.md +3 -3
  5. package/template/.claude/skills/intelligent-routing/SKILL.md +1 -1
  6. package/template/.nexus/nexus-devflow.json +1 -1
  7. package/template/AGENTS.md +3 -3
  8. package/template/devflow/context/project_index.json +108 -0
  9. package/template/.agents/skills/check-for-updates/SKILL.md +0 -117
  10. package/template/.agents/skills/devflow-concept-intake/SKILL.md +0 -150
  11. package/template/.agents/skills/devflow-concept-intake/agents/openai.yaml +0 -4
  12. package/template/.agents/skills/devflow-concept-intake/references/adoption-proposal-template.md +0 -60
  13. package/template/.agents/skills/devflow-concept-intake/references/concept-report-template.md +0 -47
  14. package/template/.agents/skills/devflow-concept-intake/references/upstream-tracking-template.md +0 -51
  15. package/template/.agents/skills/devflow-wiki/SKILL.md +0 -75
  16. package/template/.agents/skills/english-to-thai-translator/SKILL.md +0 -125
  17. package/template/.agents/skills/obsidian-bases/SKILL.md +0 -506
  18. package/template/.agents/skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md +0 -173
  19. package/template/.agents/skills/obsidian-cli/SKILL.md +0 -115
  20. package/template/.agents/skills/obsidian-clipper-template-creator/SKILL.md +0 -73
  21. package/template/.agents/skills/obsidian-clipper-template-creator/assets/clipping-template.json +0 -51
  22. package/template/.agents/skills/obsidian-clipper-template-creator/assets/recipe-template.json +0 -48
  23. package/template/.agents/skills/obsidian-clipper-template-creator/references/analysis-workflow.md +0 -79
  24. package/template/.agents/skills/obsidian-clipper-template-creator/references/bases-workflow.md +0 -44
  25. package/template/.agents/skills/obsidian-clipper-template-creator/references/filters.md +0 -51
  26. package/template/.agents/skills/obsidian-clipper-template-creator/references/json-schema.md +0 -77
  27. package/template/.agents/skills/obsidian-clipper-template-creator/references/logic.md +0 -67
  28. package/template/.agents/skills/obsidian-clipper-template-creator/references/variables.md +0 -64
  29. package/template/.agents/skills/obsidian-markdown/SKILL.md +0 -205
  30. package/template/.agents/skills/obsidian-markdown/references/CALLOUTS.md +0 -58
  31. package/template/.agents/skills/obsidian-markdown/references/EMBEDS.md +0 -63
  32. package/template/.agents/skills/obsidian-markdown/references/PROPERTIES.md +0 -61
  33. package/template/.agents/skills/prompt-addons/SKILL.md +0 -99
  34. package/template/.agents/skills/prp-dev-fastapi/SKILL.md +0 -114
  35. package/template/.agents/skills/prp-dev-multiplatform/SKILL.md +0 -36
  36. package/template/.agents/skills/prp-dev-odoo/SKILL.md +0 -71
  37. package/template/.agents/skills/prp-dev-php/SKILL.md +0 -63
  38. package/template/.agents/skills/prp-sa-ba/SKILL.md +0 -52
  39. package/template/.agents/skills/red-team-tactics/SKILL.md +0 -199
  40. package/template/.agents/skills/writing-great-skills/SKILL.md +0 -65
  41. package/template/.claude/skills/check-for-updates/SKILL.md +0 -117
  42. package/template/.claude/skills/devflow-concept-intake/SKILL.md +0 -150
  43. package/template/.claude/skills/devflow-concept-intake/agents/openai.yaml +0 -4
  44. package/template/.claude/skills/devflow-concept-intake/references/adoption-proposal-template.md +0 -60
  45. package/template/.claude/skills/devflow-concept-intake/references/concept-report-template.md +0 -47
  46. package/template/.claude/skills/devflow-concept-intake/references/upstream-tracking-template.md +0 -51
  47. package/template/.claude/skills/devflow-wiki/SKILL.md +0 -75
  48. package/template/.claude/skills/english-to-thai-translator/SKILL.md +0 -125
  49. package/template/.claude/skills/obsidian-bases/SKILL.md +0 -506
  50. package/template/.claude/skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md +0 -173
  51. package/template/.claude/skills/obsidian-cli/SKILL.md +0 -115
  52. package/template/.claude/skills/obsidian-clipper-template-creator/SKILL.md +0 -73
  53. package/template/.claude/skills/obsidian-clipper-template-creator/assets/clipping-template.json +0 -51
  54. package/template/.claude/skills/obsidian-clipper-template-creator/assets/recipe-template.json +0 -48
  55. package/template/.claude/skills/obsidian-clipper-template-creator/references/analysis-workflow.md +0 -79
  56. package/template/.claude/skills/obsidian-clipper-template-creator/references/bases-workflow.md +0 -44
  57. package/template/.claude/skills/obsidian-clipper-template-creator/references/filters.md +0 -51
  58. package/template/.claude/skills/obsidian-clipper-template-creator/references/json-schema.md +0 -77
  59. package/template/.claude/skills/obsidian-clipper-template-creator/references/logic.md +0 -67
  60. package/template/.claude/skills/obsidian-clipper-template-creator/references/variables.md +0 -64
  61. package/template/.claude/skills/obsidian-markdown/SKILL.md +0 -205
  62. package/template/.claude/skills/obsidian-markdown/references/CALLOUTS.md +0 -58
  63. package/template/.claude/skills/obsidian-markdown/references/EMBEDS.md +0 -63
  64. package/template/.claude/skills/obsidian-markdown/references/PROPERTIES.md +0 -61
  65. package/template/.claude/skills/prompt-addons/SKILL.md +0 -99
  66. package/template/.claude/skills/prp-dev-fastapi/SKILL.md +0 -114
  67. package/template/.claude/skills/prp-dev-multiplatform/SKILL.md +0 -36
  68. package/template/.claude/skills/prp-dev-odoo/SKILL.md +0 -71
  69. package/template/.claude/skills/prp-dev-php/SKILL.md +0 -63
  70. package/template/.claude/skills/prp-sa-ba/SKILL.md +0 -52
  71. package/template/.claude/skills/red-team-tactics/SKILL.md +0 -199
  72. 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)