obsidian-tasks-query
Skill2 starsChanged 2 months agoMITView on GitHub
Creates Obsidian Tasks plugin query blocks with filters, sorting, grouping, and layout options. Use when the user asks to build a task dashboard, show overdue tasks, list tasks by priority, create a task view or report in a note, write a tasks code block, group tasks by project, filter tasks by folder or date, make a weekly review page, or anything involving a tasks query block in markdown.
In this repository8 other files it gives its agents.
- obsidian-chartsSkill
- obsidian-dataviewSkill
- obsidian-graph-auditSkill
- obsidian-graphSkill
- obsidian-heatmapSkill
- obsidian-meta-bindSkill
- obsidian-tasks-cliSkill
- obsidian-tasks-syntaxSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 9
Write tasks code blocks in markdown notes.
- Distinctive: line 104
Read these when the inline patterns above aren't enough:
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Creating Task Queries
Write tasks code blocks in markdown notes. The Tasks plugin renders them as live, filtered views of tasks across the vault.
Query Block Syntax
```tasks
not done
due before tomorrow
sort by priority
```Each line is a separate instruction. All filter lines must match (implicit AND). Queries are case-insensitive except boolean operators (AND, OR, NOT must be UPPERCASE — lowercase is silently ignored). Add explain to any query to debug how Tasks interprets it.
Common Patterns
Overdue tasks:
```tasks
not done
due before today
sort by due
```Due this week, grouped by file:
```tasks
not done
due this week
group by filename
sort by due
```High priority:
```tasks
not done
(priority is highest) OR (priority is high)
sort by due
```Exclude folders:
```tasks
not done
(folder does not include Templates) AND (folder does not include Archive)
sort by due
```Backlog (no dates):
```tasks
not done
no due date
no scheduled date
sort by path
limit 20
```These cover the most common cases. For anything more complex — date ranges, custom scripting, regex filters, layout options — read the reference files below.
Overriding the Global Query
The Tasks plugin has a globalQuery setting (Settings → Tasks → Global query) that prepends to every query block. To run a block without it — for example a "show everything" view, or to look at items the user has globally hidden — add ignore global query as the first line:
```tasks
ignore global query
not done
group by filename
```This disables the entire globalQuery for that block. Selective override of individual lines is not supported — it's all or nothing. Use this when you specifically want to surface tasks the global filter normally hides (e.g. items tagged #wishlist or #learning in frontmatter).
Boolean Filters
Combine multiple conditions on a single line with operators:
(filter 1) AND (filter 2)
(filter 1) OR (filter 2)
NOT (filter 1)
(filter 1) AND NOT (filter 2)Operators must be UPPERCASE — this is a common mistake. and/or in lowercase are silently ignored, making the query behave unexpectedly. Delimiters: (), [], {}, "" (don't mix types on one line).
Reference Documentation
Read these when the inline patterns above aren't enough:
- Query Reference — complete filter, sorting, grouping, layout options, boolean combinations, and custom scripting. Read when you need a specific filter syntax or want to check available sort/group fields.
- Examples — more query recipes including dependencies, compact views, task trees, and date category grouping. Read when building a complex dashboard or looking for inspiration.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

