@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,205 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: obsidian-markdown
|
|
3
|
-
description: Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.
|
|
4
|
-
risk: unknown
|
|
5
|
-
source: "https://github.com/kepano/obsidian-skills"
|
|
6
|
-
date_added: "2026-03-21"
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Obsidian Flavored Markdown Skill
|
|
10
|
-
|
|
11
|
-
Create and edit valid Obsidian Flavored Markdown. Obsidian extends CommonMark and GFM with wikilinks, embeds, callouts, properties, comments, and other syntax. This skill covers only Obsidian-specific extensions -- standard Markdown (headings, bold, italic, lists, quotes, code blocks, tables) is assumed knowledge.
|
|
12
|
-
|
|
13
|
-
## When to Use
|
|
14
|
-
|
|
15
|
-
- Use when writing or editing Markdown notes intended for Obsidian.
|
|
16
|
-
- Use when the task involves wikilinks, embeds, callouts, frontmatter properties, or Obsidian-specific syntax.
|
|
17
|
-
- Use when the user wants notes that render correctly inside an Obsidian vault.
|
|
18
|
-
|
|
19
|
-
## Workflow: Creating an Obsidian Note
|
|
20
|
-
|
|
21
|
-
1. **Add frontmatter** with properties (title, tags, aliases) at the top of the file. See [PROPERTIES.md](references/PROPERTIES.md) for all property types.
|
|
22
|
-
2. **Write content** using standard Markdown for structure, plus Obsidian-specific syntax below.
|
|
23
|
-
3. **Link related notes** using wikilinks (`[[Note]]`) for internal vault connections, or standard Markdown links for external URLs.
|
|
24
|
-
4. **Embed content** from other notes, images, or PDFs using the `![[embed]]` syntax. See [EMBEDS.md](references/EMBEDS.md) for all embed types.
|
|
25
|
-
5. **Add callouts** for highlighted information using `> [!type]` syntax. See [CALLOUTS.md](references/CALLOUTS.md) for all callout types.
|
|
26
|
-
6. **Verify** the note renders correctly in Obsidian's reading view.
|
|
27
|
-
|
|
28
|
-
> When choosing between wikilinks and Markdown links: use `[[wikilinks]]` for notes within the vault (Obsidian tracks renames automatically) and plain Markdown links for external URLs only.
|
|
29
|
-
|
|
30
|
-
## Internal Links (Wikilinks)
|
|
31
|
-
|
|
32
|
-
```markdown
|
|
33
|
-
[[Note Name]] Link to note
|
|
34
|
-
[[Note Name|Display Text]] Custom display text
|
|
35
|
-
[[Note Name#Heading]] Link to heading
|
|
36
|
-
[[Note Name#^block-id]] Link to block
|
|
37
|
-
[[#Heading in same note]] Same-note heading link
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
Define a block ID by appending `^block-id` to any paragraph:
|
|
41
|
-
|
|
42
|
-
```markdown
|
|
43
|
-
This paragraph can be linked to. ^my-block-id
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
For lists and quotes, place the block ID on a separate line after the block:
|
|
47
|
-
|
|
48
|
-
```markdown
|
|
49
|
-
> A quote block
|
|
50
|
-
|
|
51
|
-
^quote-id
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
## Embeds
|
|
55
|
-
|
|
56
|
-
Prefix any wikilink with `!` to embed its content inline:
|
|
57
|
-
|
|
58
|
-
```markdown
|
|
59
|
-
![[Note Name]] Embed full note
|
|
60
|
-
![[Note Name#Heading]] Embed section
|
|
61
|
-
![[image.png]] Embed image
|
|
62
|
-
![[image.png|300]] Embed image with width
|
|
63
|
-
![[document.pdf#page=3]] Embed PDF page
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
See [EMBEDS.md](references/EMBEDS.md) for audio, video, search embeds, and external images.
|
|
67
|
-
|
|
68
|
-
## Callouts
|
|
69
|
-
|
|
70
|
-
```markdown
|
|
71
|
-
> [!note]
|
|
72
|
-
> Basic callout.
|
|
73
|
-
|
|
74
|
-
> [!warning] Custom Title
|
|
75
|
-
> Callout with a custom title.
|
|
76
|
-
|
|
77
|
-
> [!faq]- Collapsed by default
|
|
78
|
-
> Foldable callout (- collapsed, + expanded).
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
Common types: `note`, `tip`, `warning`, `info`, `example`, `quote`, `bug`, `danger`, `success`, `failure`, `question`, `abstract`, `todo`.
|
|
82
|
-
|
|
83
|
-
See [CALLOUTS.md](references/CALLOUTS.md) for the full list with aliases, nesting, and custom CSS callouts.
|
|
84
|
-
|
|
85
|
-
## Properties (Frontmatter)
|
|
86
|
-
|
|
87
|
-
```yaml
|
|
88
|
-
---
|
|
89
|
-
title: My Note
|
|
90
|
-
date: 2024-01-15
|
|
91
|
-
tags:
|
|
92
|
-
- project
|
|
93
|
-
- active
|
|
94
|
-
aliases:
|
|
95
|
-
- Alternative Name
|
|
96
|
-
cssclasses:
|
|
97
|
-
- custom-class
|
|
98
|
-
---
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
Default properties: `tags` (searchable labels), `aliases` (alternative note names for link suggestions), `cssclasses` (CSS classes for styling).
|
|
102
|
-
|
|
103
|
-
See [PROPERTIES.md](references/PROPERTIES.md) for all property types, tag syntax rules, and advanced usage.
|
|
104
|
-
|
|
105
|
-
## Tags
|
|
106
|
-
|
|
107
|
-
```markdown
|
|
108
|
-
#tag Inline tag
|
|
109
|
-
#nested/tag Nested tag with hierarchy
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
Tags can contain letters, numbers (not first character), underscores, hyphens, and forward slashes. Tags can also be defined in frontmatter under the `tags` property.
|
|
113
|
-
|
|
114
|
-
## Comments
|
|
115
|
-
|
|
116
|
-
```markdown
|
|
117
|
-
This is visible %%but this is hidden%% text.
|
|
118
|
-
|
|
119
|
-
%%
|
|
120
|
-
This entire block is hidden in reading view.
|
|
121
|
-
%%
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
## Obsidian-Specific Formatting
|
|
125
|
-
|
|
126
|
-
```markdown
|
|
127
|
-
==Highlighted text== Highlight syntax
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
## Math (LaTeX)
|
|
131
|
-
|
|
132
|
-
```markdown
|
|
133
|
-
Inline: $e^{i\pi} + 1 = 0$
|
|
134
|
-
|
|
135
|
-
Block:
|
|
136
|
-
$$
|
|
137
|
-
\frac{a}{b} = c
|
|
138
|
-
$$
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
## Diagrams (Mermaid)
|
|
142
|
-
|
|
143
|
-
````markdown
|
|
144
|
-
```mermaid
|
|
145
|
-
graph TD
|
|
146
|
-
A[Start] --> B{Decision}
|
|
147
|
-
B -->|Yes| C[Do this]
|
|
148
|
-
B -->|No| D[Do that]
|
|
149
|
-
```
|
|
150
|
-
````
|
|
151
|
-
|
|
152
|
-
To link Mermaid nodes to Obsidian notes, add `class NodeName internal-link;`.
|
|
153
|
-
|
|
154
|
-
## Footnotes
|
|
155
|
-
|
|
156
|
-
```markdown
|
|
157
|
-
Text with a footnote[^1].
|
|
158
|
-
|
|
159
|
-
[^1]: Footnote content.
|
|
160
|
-
|
|
161
|
-
Inline footnote.^[This is inline.]
|
|
162
|
-
```
|
|
163
|
-
|
|
164
|
-
## Complete Example
|
|
165
|
-
|
|
166
|
-
````markdown
|
|
167
|
-
---
|
|
168
|
-
title: Project Alpha
|
|
169
|
-
date: 2024-01-15
|
|
170
|
-
tags:
|
|
171
|
-
- project
|
|
172
|
-
- active
|
|
173
|
-
status: in-progress
|
|
174
|
-
---
|
|
175
|
-
|
|
176
|
-
# Project Alpha
|
|
177
|
-
|
|
178
|
-
This project aims to [[improve workflow]] using modern techniques.
|
|
179
|
-
|
|
180
|
-
> [!important] Key Deadline
|
|
181
|
-
> The first milestone is due on ==January 30th==.
|
|
182
|
-
|
|
183
|
-
## Tasks
|
|
184
|
-
|
|
185
|
-
- [x] Initial planning
|
|
186
|
-
- [ ] Development phase
|
|
187
|
-
- [ ] Backend implementation
|
|
188
|
-
- [ ] Frontend design
|
|
189
|
-
|
|
190
|
-
## Notes
|
|
191
|
-
|
|
192
|
-
The algorithm uses $O(n \log n)$ sorting. See [[Algorithm Notes#Sorting]] for details.
|
|
193
|
-
|
|
194
|
-
![[Architecture Diagram.png|600]]
|
|
195
|
-
|
|
196
|
-
Reviewed in [[Meeting Notes 2024-01-10#Decisions]].
|
|
197
|
-
````
|
|
198
|
-
|
|
199
|
-
## References
|
|
200
|
-
|
|
201
|
-
- [Obsidian Flavored Markdown](https://help.obsidian.md/obsidian-flavored-markdown)
|
|
202
|
-
- [Internal links](https://help.obsidian.md/links)
|
|
203
|
-
- [Embed files](https://help.obsidian.md/embeds)
|
|
204
|
-
- [Callouts](https://help.obsidian.md/callouts)
|
|
205
|
-
- [Properties](https://help.obsidian.md/properties)
|
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
# Callouts Reference
|
|
2
|
-
|
|
3
|
-
## Basic Callout
|
|
4
|
-
|
|
5
|
-
```markdown
|
|
6
|
-
> [!note]
|
|
7
|
-
> This is a note callout.
|
|
8
|
-
|
|
9
|
-
> [!info] Custom Title
|
|
10
|
-
> This callout has a custom title.
|
|
11
|
-
|
|
12
|
-
> [!tip] Title Only
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
## Foldable Callouts
|
|
16
|
-
|
|
17
|
-
```markdown
|
|
18
|
-
> [!faq]- Collapsed by default
|
|
19
|
-
> This content is hidden until expanded.
|
|
20
|
-
|
|
21
|
-
> [!faq]+ Expanded by default
|
|
22
|
-
> This content is visible but can be collapsed.
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
## Nested Callouts
|
|
26
|
-
|
|
27
|
-
```markdown
|
|
28
|
-
> [!question] Outer callout
|
|
29
|
-
> > [!note] Inner callout
|
|
30
|
-
> > Nested content
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
## Supported Callout Types
|
|
34
|
-
|
|
35
|
-
| Type | Aliases | Color / Icon |
|
|
36
|
-
|------|---------|-------------|
|
|
37
|
-
| `note` | - | Blue, pencil |
|
|
38
|
-
| `abstract` | `summary`, `tldr` | Teal, clipboard |
|
|
39
|
-
| `info` | - | Blue, info |
|
|
40
|
-
| `todo` | - | Blue, checkbox |
|
|
41
|
-
| `tip` | `hint`, `important` | Cyan, flame |
|
|
42
|
-
| `success` | `check`, `done` | Green, checkmark |
|
|
43
|
-
| `question` | `help`, `faq` | Yellow, question mark |
|
|
44
|
-
| `warning` | `caution`, `attention` | Orange, warning |
|
|
45
|
-
| `failure` | `fail`, `missing` | Red, X |
|
|
46
|
-
| `danger` | `error` | Red, zap |
|
|
47
|
-
| `bug` | - | Red, bug |
|
|
48
|
-
| `example` | - | Purple, list |
|
|
49
|
-
| `quote` | `cite` | Gray, quote |
|
|
50
|
-
|
|
51
|
-
## Custom Callouts (CSS)
|
|
52
|
-
|
|
53
|
-
```css
|
|
54
|
-
.callout[data-callout="custom-type"] {
|
|
55
|
-
--callout-color: 255, 0, 0;
|
|
56
|
-
--callout-icon: lucide-alert-circle;
|
|
57
|
-
}
|
|
58
|
-
```
|
|
@@ -1,63 +0,0 @@
|
|
|
1
|
-
# Embeds Reference
|
|
2
|
-
|
|
3
|
-
## Embed Notes
|
|
4
|
-
|
|
5
|
-
```markdown
|
|
6
|
-
![[Note Name]]
|
|
7
|
-
![[Note Name#Heading]]
|
|
8
|
-
![[Note Name#^block-id]]
|
|
9
|
-
```
|
|
10
|
-
|
|
11
|
-
## Embed Images
|
|
12
|
-
|
|
13
|
-
```markdown
|
|
14
|
-
![[image.png]]
|
|
15
|
-
![[image.png|640x480]] Width x Height
|
|
16
|
-
![[image.png|300]] Width only (maintains aspect ratio)
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
## External Images
|
|
20
|
-
|
|
21
|
-
```markdown
|
|
22
|
-

|
|
23
|
-

|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Embed Audio
|
|
27
|
-
|
|
28
|
-
```markdown
|
|
29
|
-
![[audio.mp3]]
|
|
30
|
-
![[audio.ogg]]
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
## Embed PDF
|
|
34
|
-
|
|
35
|
-
```markdown
|
|
36
|
-
![[document.pdf]]
|
|
37
|
-
![[document.pdf#page=3]]
|
|
38
|
-
![[document.pdf#height=400]]
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
## Embed Lists
|
|
42
|
-
|
|
43
|
-
```markdown
|
|
44
|
-
![[Note#^list-id]]
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
Where the list has a block ID:
|
|
48
|
-
|
|
49
|
-
```markdown
|
|
50
|
-
- Item 1
|
|
51
|
-
- Item 2
|
|
52
|
-
- Item 3
|
|
53
|
-
|
|
54
|
-
^list-id
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
## Embed Search Results
|
|
58
|
-
|
|
59
|
-
````markdown
|
|
60
|
-
```query
|
|
61
|
-
tag:#project status:done
|
|
62
|
-
```
|
|
63
|
-
````
|
|
@@ -1,61 +0,0 @@
|
|
|
1
|
-
# Properties (Frontmatter) Reference
|
|
2
|
-
|
|
3
|
-
Properties use YAML frontmatter at the start of a note:
|
|
4
|
-
|
|
5
|
-
```yaml
|
|
6
|
-
---
|
|
7
|
-
title: My Note Title
|
|
8
|
-
date: 2024-01-15
|
|
9
|
-
tags:
|
|
10
|
-
- project
|
|
11
|
-
- important
|
|
12
|
-
aliases:
|
|
13
|
-
- My Note
|
|
14
|
-
- Alternative Name
|
|
15
|
-
cssclasses:
|
|
16
|
-
- custom-class
|
|
17
|
-
status: in-progress
|
|
18
|
-
rating: 4.5
|
|
19
|
-
completed: false
|
|
20
|
-
due: 2024-02-01T14:30:00
|
|
21
|
-
---
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
## Property Types
|
|
25
|
-
|
|
26
|
-
| Type | Example |
|
|
27
|
-
|------|---------|
|
|
28
|
-
| Text | `title: My Title` |
|
|
29
|
-
| Number | `rating: 4.5` |
|
|
30
|
-
| Checkbox | `completed: true` |
|
|
31
|
-
| Date | `date: 2024-01-15` |
|
|
32
|
-
| Date & Time | `due: 2024-01-15T14:30:00` |
|
|
33
|
-
| List | `tags: [one, two]` or YAML list |
|
|
34
|
-
| Links | `related: "[[Other Note]]"` |
|
|
35
|
-
|
|
36
|
-
## Default Properties
|
|
37
|
-
|
|
38
|
-
- `tags` - Note tags (searchable, shown in graph view)
|
|
39
|
-
- `aliases` - Alternative names for the note (used in link suggestions)
|
|
40
|
-
- `cssclasses` - CSS classes applied to the note in reading/editing view
|
|
41
|
-
|
|
42
|
-
## Tags
|
|
43
|
-
|
|
44
|
-
```markdown
|
|
45
|
-
#tag
|
|
46
|
-
#nested/tag
|
|
47
|
-
#tag-with-dashes
|
|
48
|
-
#tag_with_underscores
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
Tags can contain: letters (any language), numbers (not first character), underscores `_`, hyphens `-`, forward slashes `/` (for nesting).
|
|
52
|
-
|
|
53
|
-
In frontmatter:
|
|
54
|
-
|
|
55
|
-
```yaml
|
|
56
|
-
---
|
|
57
|
-
tags:
|
|
58
|
-
- tag1
|
|
59
|
-
- nested/tag2
|
|
60
|
-
---
|
|
61
|
-
```
|
|
@@ -1,99 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: prompt-addons
|
|
3
|
-
description: Routes external prompt families into DevFlow 2.0 workflows, specialist agents, or thin skill aliases. Use when deciding whether a prompt-inspired behavior should become a mainline workflow, a companion command, a reusable skill, or remain legacy-only.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Prompt Addons
|
|
7
|
-
|
|
8
|
-
Use this skill when adapting outside prompt patterns into the DevFlow 2.0 system.
|
|
9
|
-
|
|
10
|
-
## Core Rule
|
|
11
|
-
|
|
12
|
-
Adapt intent, not old output contracts.
|
|
13
|
-
|
|
14
|
-
DevFlow 2.0 uses a stage-based, markdown-first model:
|
|
15
|
-
|
|
16
|
-
1. Mainline workflow stays minimal and ordered
|
|
17
|
-
2. Companion commands exist for non-mainline help
|
|
18
|
-
3. Specialist agents and skills handle reusable methods
|
|
19
|
-
4. JSON-first orchestration is legacy and should not define new architecture
|
|
20
|
-
|
|
21
|
-
## Mainline Routing
|
|
22
|
-
|
|
23
|
-
| Need | Route to |
|
|
24
|
-
| :--- | :--- |
|
|
25
|
-
| Explore problem space | `/00-Discover` |
|
|
26
|
-
| Clarify goal, scope, decisions | `/10-Define` |
|
|
27
|
-
| Lock delivery contract | `/20-Spec` |
|
|
28
|
-
| Break into execution plan | `/30-Plan` |
|
|
29
|
-
| Build the change | `/40-Implement` |
|
|
30
|
-
| Validate quality and evidence | `/50-Verify` |
|
|
31
|
-
| Package release-ready outcome | `/70-Release` |
|
|
32
|
-
| Summarize the full run | `/60-Report` |
|
|
33
|
-
|
|
34
|
-
## Companion Command Routing
|
|
35
|
-
|
|
36
|
-
| Command | Use when | Typical stage pairing |
|
|
37
|
-
| :--- | :--- | :--- |
|
|
38
|
-
| `Brainstorm` | เนเธเธเธขเนเธขเธฑเธเนเธกเนเธเธดเนเธ เธเนเธญเธเธเธดเธเธเธฒเธเนเธฅเธทเธญเธเธเนเธญเธ lock | Discover, Define |
|
|
39
|
-
| `Research` | เธเนเธญเธเธซเธฒเธซเธฅเธฑเธเธเธฒเธเธซเธฃเธทเธญเธเนเธญเธกเธนเธฅเนเธเธดเนเธก | Discover, Define, Spec, Verify |
|
|
40
|
-
| `Debug` | เธเธฒเธเธเธดเธเธเธเธเธด เธเนเธญเธเธซเธฒ root cause | Implement, Verify |
|
|
41
|
-
| `Preview` | เธเนเธญเธเธเธฃเธงเธเธเธดเนเธเธเธฒเธเธฃเธฐเธซเธงเนเธฒเธเธเธฒเธ | Implement, Verify |
|
|
42
|
-
| `Wiki` | เธเนเธญเธเธชเธเธฑเธเธเธงเธฒเธกเธฃเธนเน reusable | Verify, Release, Report |
|
|
43
|
-
| `Help` | เธเธนเนเนเธเนเนเธกเนเนเธเนเนเธเธงเนเธฒเธเธฐเนเธฃเธดเนเธกเธเธฃเธเนเธซเธ | เธเนเธญเธเนเธเนเธฒ stage เธซเธฃเธทเธญเธฃเธฐเธซเธงเนเธฒเธเธเธฒเธ |
|
|
44
|
-
|
|
45
|
-
## Classification Rule
|
|
46
|
-
|
|
47
|
-
เธเนเธญเธเธชเธฃเนเธฒเธ workflow เนเธซเธกเน เนเธซเนเธเธฑเธเธเธฃเธฐเนเธ เธเธเนเธญเธ:
|
|
48
|
-
|
|
49
|
-
1. เธเนเธฒ intent เนเธเธฅเธตเนเธขเธ stage เธเธญเธเธเธฒเธ เนเธซเน route เนเธเนเธฒเธชเธนเน mainline stage เธเธตเนเธกเธตเธญเธขเธนเน
|
|
50
|
-
2. เธเนเธฒเนเธเนเธเธงเธดเธเธตเธเธณเธเธฒเธเธเธตเนเนเธเนเธเนเธณเธซเธฅเธฒเธข stage เนเธซเนเนเธเนเธ skill
|
|
51
|
-
3. เธเนเธฒเนเธเนเธเธเธงเธฒเธกเนเธเธตเนเธขเธงเธเธฒเธเนเธเธเธฒเธฐเธเนเธฒเธ เนเธซเนเนเธเนเธ agent
|
|
52
|
-
4. เธเนเธฒเนเธเนเธเนเธเนเธเธฑเธงเธเนเธงเธขเธเธดเธเธซเธฃเธทเธญเธซเธฒเธซเธฅเธฑเธเธเธฒเธเธฃเธฐเธซเธงเนเธฒเธเธเธฒเธ เนเธซเนเนเธเนเธ companion command
|
|
53
|
-
5. เธเนเธฒเธญเธดเธ dashboard/json orchestration เนเธเธดเธกเนเธเนเธเธซเธฅเธฑเธ เนเธซเนเธเธเนเธงเนเนเธเนเธ legacy เธซเธฃเธทเธญ migration note
|
|
54
|
-
|
|
55
|
-
## Prompt Family Routing
|
|
56
|
-
|
|
57
|
-
| Family | DevFlow 2.0 route | Keep as |
|
|
58
|
-
| :--- | :--- | :--- |
|
|
59
|
-
| Spec | `/10-Define`, `/20-Spec`, `/30-Plan` | workflow + `requirements-engineer` |
|
|
60
|
-
| Complexity | `/10-Define`, `/30-Plan` | workflow content, not standalone mainline |
|
|
61
|
-
| Roadmap | Discover/Define adjacent | skill or optional workflow outside core line |
|
|
62
|
-
| Ideation | `Brainstorm`, `Research` | companion command |
|
|
63
|
-
| Competitor | `Research` during Discover/Define | companion command or research skill |
|
|
64
|
-
| Insight | `Wiki`, `/60-Report` | companion command + report content |
|
|
65
|
-
| Coder | `/40-Implement` | workflow + specialist agents |
|
|
66
|
-
| QA | `/50-Verify` | workflow + QA/test skills |
|
|
67
|
-
| Follow-up | `/10-Define` or `/30-Plan` เธเธญเธเธฃเธญเธเนเธซเธกเน | stage reuse, not separate numbered mainline |
|
|
68
|
-
| GitHub review | `/50-Verify`, `/70-Release` | workflow/agent support |
|
|
69
|
-
| MCP tool validation | `/50-Verify` | tool-specific verification skill |
|
|
70
|
-
|
|
71
|
-
## Borderline Rules
|
|
72
|
-
|
|
73
|
-
| Idea | Route | Keep as | Rule |
|
|
74
|
-
| :--- | :--- | :--- | :--- |
|
|
75
|
-
| Validation fixer | `/50-Verify` เนเธฅเนเธงเธเนเธญเธขเธขเนเธญเธ `/40-Implement` เธเนเธฒเธเนเธญเธเนเธเนเนเธเนเธ | thin skill/process note | เนเธซเน verification เธเธตเน failure เธเนเธญเธเนเธชเธกเธญ |
|
|
76
|
-
| Documentation ideation | `Brainstorm`, `Wiki`, `/60-Report` | skill-backed support | เนเธกเนเธเนเธญเธเนเธเธดเธ mainline เนเธซเธกเน |
|
|
77
|
-
| Performance ideation | `/50-Verify` เธซเธฃเธทเธญ `/40-Implement` เนเธกเธทเนเธญเธกเธตเธซเธฅเธฑเธเธเธฒเธ | specialist skill/agent | เธเนเธญเธเธกเธต measurement |
|
|
78
|
-
| Security ideation | `/50-Verify` เธซเธฃเธทเธญ `Debug` เนเธกเธทเนเธญเธกเธต incident symptom | specialist skill/agent | treat as finding-first |
|
|
79
|
-
| Follow-up planning | `/10-Define` -> `/20-Spec` -> `/30-Plan` เธเธญเธเธฃเธญเธเนเธซเธกเน | mainline reuse | เนเธกเนเนเธขเธ workflow เธซเธกเธฒเธขเนเธฅเธเนเธซเธกเน |
|
|
80
|
-
| Legacy dashboard orchestration | legacy note only | migration-only | เนเธกเนเนเธเนเนเธเนเธเนเธเธเธเธฑเนเธเธเนเธเธเธญเธ DevFlow 2.0 |
|
|
81
|
-
|
|
82
|
-
## Follow-Up Planning
|
|
83
|
-
|
|
84
|
-
เนเธกเธทเนเธญเธเธนเนเนเธเนเธเนเธญเธเธเธฒเธฃเธเนเธญเธขเธญเธเธเธฒเธเนเธเธดเธก:
|
|
85
|
-
|
|
86
|
-
1. เธญเนเธฒเธ stage artifacts เธเธตเนเธกเธตเธญเธขเธนเนเธเธญเธ running ID เนเธเธดเธก
|
|
87
|
-
2. เธฃเธฐเธเธธเนเธซเนเธเธฑเธเธงเนเธฒเธญเธฐเนเธฃ lock เนเธฅเนเธง เนเธฅเธฐเธญเธฐเนเธฃเธเธฐเนเธเธดเนเธกเนเธซเธกเน
|
|
88
|
-
3. เนเธฃเธดเนเธกเธฃเธญเธเนเธซเธกเนเธเธฒเธ `/10-Define` เธเนเธฒเนเธเธเธขเนเนเธเธฅเธตเนเธขเธ เธซเธฃเธทเธญ `/30-Plan` เธเนเธฒ spec เธขเธฑเธเนเธเนเนเธเน
|
|
89
|
-
4. เนเธเนเนเธเธฅเน `.md` เธเธญเธ stage เนเธซเธกเนเนเธเนเธเธซเธฅเธฑเธเนเธเธเธฒเธฃเธเธฑเธเธเธถเธเธเธฃเธดเธเธ
|
|
90
|
-
|
|
91
|
-
## Output Principle
|
|
92
|
-
|
|
93
|
-
เนเธกเธทเนเธญ prompt family เธเธนเธเนเธเธฅเธเนเธเนเธฒเธฃเธฐเธเธ:
|
|
94
|
-
|
|
95
|
-
1. เธญเธขเนเธฒ copy contract เนเธเธดเธกเนเธเนเธฒเธกเธฒเธเธฃเธ เน
|
|
96
|
-
2. เนเธเธฅเธเนเธซเนเธชเธญเธเธเธฅเนเธญเธเธเธฑเธ numbering rule เธเธญเธ DevFlow 2.0
|
|
97
|
-
3. เธญเธขเนเธฒเธเธณเนเธซเนเธเธนเนเนเธเนเธเนเธญเธเนเธเธฒเนเธฅเธเธขเนเธญเธเธเธฅเธฑเธ
|
|
98
|
-
4. เนเธซเน mainline เธกเธตเนเธเธเธฒเธฐ state เธเธญเธเธเธฒเธ
|
|
99
|
-
5. เนเธซเนเธเธงเธฒเธกเธชเธฒเธกเธฒเธฃเธเนเธชเธฃเธดเธกเนเธเธญเธขเธนเนเนเธ skill, agent, เธซเธฃเธทเธญ companion command เธเธฒเธกเธเธงเธฒเธกเนเธซเธกเธฒเธฐเธชเธก
|
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: prp-dev-fastapi
|
|
3
|
-
description: Comprehensive skill for FastAPI development following the PRP Pure Agentic workflow. Includes project templates, async/await patterns, Pydantic validation, repository/service architecture, and automated validation loops. Use when designing, implementation, or refactoring FastAPI applications.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# ๐ PRP Dev โ FastAPI (Pure Agentic)
|
|
7
|
-
|
|
8
|
-
This Skill operates to assist the AI Agent in systematically developing features for **FastAPI** following the PRP Framework standards, focusing on Architectural correctness, clean code, and automated Validation Loops.
|
|
9
|
-
|
|
10
|
-
## ๐ฏ Scope of Work
|
|
11
|
-
Apply this Skill when:
|
|
12
|
-
- **Design**: Designing the API structure or Database Schema.
|
|
13
|
-
- **Implementation**: Writing FastAPI code, Pydantic Models, or the Service Layer.
|
|
14
|
-
- **Refactor**: Revamping legacy code for better organization or full Async compatibility.
|
|
15
|
-
- **Workflow**: When engaging in tasks related to Backend APIs (spanning from planning to Verify).
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
19
|
-
## 1. ๐ Platform & Stack Detection
|
|
20
|
-
Always ascertain the environment prior to starting work:
|
|
21
|
-
1. **Indicators**: Locate `FastAPI` in `main.py`, `requirements.txt`, or through `@app.get()` decorators.
|
|
22
|
-
2. **Database/ORM**: Identify the utilization of `SQLAlchemy` (Async/Sync), `SQLModel`, or `Tortoise`.
|
|
23
|
-
3. **Pydantic**: Confirm whether Version 1.x or 2.x is used (to guarantee proper Syntax).
|
|
24
|
-
4. **Project Type**: Examine if the structure is Monolithic (Small) or Modular (Production-Ready).
|
|
25
|
-
|
|
26
|
-
---
|
|
27
|
-
|
|
28
|
-
## 2. ๐๏ธ Architecture & Organization
|
|
29
|
-
Adhere to a Production-Ready architecture (strive to avoid files exceeding 500 lines):
|
|
30
|
-
|
|
31
|
-
```text
|
|
32
|
-
app/
|
|
33
|
-
โโโ api/ # API route handlers
|
|
34
|
-
โโโ core/ # config, security, database setup
|
|
35
|
-
โโโ models/ # Database models (ORM)
|
|
36
|
-
โโโ schemas/ # Pydantic schemas (Request/Response)
|
|
37
|
-
โโโ services/ # Business logic layer
|
|
38
|
-
โโโ repositories/ # Data access layer (CRUD)
|
|
39
|
-
โโโ utils/ # Utility functions
|
|
40
|
-
โโโ main.py # Application entry
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
### Naming Conventions
|
|
44
|
-
- **Files**: `snake_case` (e.g., `auth_service.py`)
|
|
45
|
-
- **Classes**: `PascalCase` (e.g., `UserUpdate`)
|
|
46
|
-
- **Functions**: `snake_case` (e.g., `get_active_users`)
|
|
47
|
-
- **Endpoints**: `kebab-case` (e.g., `/api/v1/user-profiles`)
|
|
48
|
-
|
|
49
|
-
---
|
|
50
|
-
|
|
51
|
-
## 3. ๐ก๏ธ Implementation Patterns (Best Practices)
|
|
52
|
-
|
|
53
|
-
### 3.1 Async All The Way
|
|
54
|
-
- Employ `async def` consistently for Endpoints.
|
|
55
|
-
- Utilize `await` for all I/O operations (Database, API Call, File System).
|
|
56
|
-
- **Prohibited**: Using Blocking code inside an Async function (e.g., `time.sleep`, `requests.get`). Employ `asyncio.sleep` or `httpx` instead.
|
|
57
|
-
|
|
58
|
-
### 3.2 Dependency Injection (FastAPI `Depends`)
|
|
59
|
-
Use `Depends` for managing Shared resources:
|
|
60
|
-
```python
|
|
61
|
-
@router.post("/", response_model=Item)
|
|
62
|
-
async def create_item(
|
|
63
|
-
item_in: ItemCreate,
|
|
64
|
-
db: AsyncSession = Depends(get_db),
|
|
65
|
-
current_user: User = Depends(get_current_user)
|
|
66
|
-
):
|
|
67
|
-
return await service.create(db, obj_in=item_in, user=current_user)
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
### 3.3 CRUD Repository Pattern
|
|
71
|
-
Segregate Data management Logic from Business Logic:
|
|
72
|
-
```python
|
|
73
|
-
# repositories/base.py
|
|
74
|
-
class BaseRepository(Generic[ModelType, CreateSchema, UpdateSchema]):
|
|
75
|
-
async def get(self, db: AsyncSession, id: Any) -> Optional[ModelType]:
|
|
76
|
-
result = await db.execute(select(self.model).where(self.model.id == id))
|
|
77
|
-
return result.scalars().first()
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
---
|
|
81
|
-
|
|
82
|
-
## 4. ๐ PRP Workflow Integration (Pure Agentic)
|
|
83
|
-
For each Task, the Agent must adhere to these principles:
|
|
84
|
-
|
|
85
|
-
### Phase: Planning (/30-Plan)
|
|
86
|
-
- Designate the files to be created/modified in the `File & Directory Index`.
|
|
87
|
-
- Formulate a comprehensive `Validation Loop`:
|
|
88
|
-
- **Step 1**: Lint & Type Check (`ruff`, `mypy`)
|
|
89
|
-
- **Step 2**: Unit Test (`pytest`)
|
|
90
|
-
- **Step 3**: Integration Test (Start the server and `curl` or use `httpx`)
|
|
91
|
-
|
|
92
|
-
### Phase: Implement (/40-Implement)
|
|
93
|
-
- Proceed with subtasks sequentially and update `implement.md` as the primary progress record.
|
|
94
|
-
- When producing a new Endpoint, consistently generate the corresponding Pydantic Schema and Test simultaneously.
|
|
95
|
-
|
|
96
|
-
### Phase: Verify (/50-Verify)
|
|
97
|
-
- Execute all commands outlined in the `Validation Loop`.
|
|
98
|
-
- Should an Error emerge, the AI must diagnose and rectify it promptly (Fix-Forward).
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
|
|
102
|
-
## ๐งช Testing & Validation
|
|
103
|
-
- **Framework**: Utilize `pytest` alongside `pytest-asyncio`.
|
|
104
|
-
- **Mocking**: Adopt `unittest.mock` or `pytest-mock` for External services.
|
|
105
|
-
- **Async Client**: Use `httpx.AsyncClient` to dispatch Requests to FastAPI.
|
|
106
|
-
- **Evidence**: Document passed outcomes in `verify.md` as the primary verification record.
|
|
107
|
-
|
|
108
|
-
---
|
|
109
|
-
|
|
110
|
-
## โก Quick Reference: Common Gotchas
|
|
111
|
-
- **Pydantic v2**: Employ `model_dump()` instead of `dict()` and `model_validate()` rather than `from_orm()`.
|
|
112
|
-
- **SQLAlchemy Async**: Necessitates the `postgresql+asyncpg://` schema and requires `await session.commit()`.
|
|
113
|
-
- **FastAPI Middleware**: Be cautious regarding the insertion sequence of Middleware (CORS should commonly be near the end or customized based on Auth requirements).
|
|
114
|
-
- **Token Efficiency**: Should a file grow excessively long, propose Module Splitting as early as the Planning phase.
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: prp-dev-multiplatform
|
|
3
|
-
description: Intelligent platform router for PRP development. Automatically detects whether the project is FastAPI, Odoo, or PHP and provides guidance on which specific skill to use.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# ๐ฆ PRP Dev โ Platform Router (Pure Agentic)
|
|
7
|
-
|
|
8
|
-
This Skill functions as an **"Intelligent Receptionist"**, helping detect the technology powering your current project and directing other AIs (or myself) to adopt the appropriate specialized Skill for the job.
|
|
9
|
-
|
|
10
|
-
## ๐ Platform Detection Logic
|
|
11
|
-
|
|
12
|
-
When kick-starting a new task or if the environment is ambiguous, I will scan the files as follows:
|
|
13
|
-
|
|
14
|
-
### 1. ๐ FastAPI
|
|
15
|
-
- **Check**: `main.py`, `app.py` featuring `from fastapi import FastAPI`, or a `requirements.txt` file listing `fastapi`.
|
|
16
|
-
- **Recommended Skill**: `prp-dev-fastapi`
|
|
17
|
-
|
|
18
|
-
### 2. ๐ฆ Odoo (ERP)
|
|
19
|
-
- **Check**: The `addons/` folder, `__manifest__.py` (for versions 13+), or `__openerp__.py` (for version 8).
|
|
20
|
-
- **Recommended Skill**: `prp-dev-odoo`
|
|
21
|
-
|
|
22
|
-
### 3. ๐ PHP (CI/Yii)
|
|
23
|
-
- **Check**: The `application/` folder (CodeIgniter) or the `vendor/yiisoft/` folder (Yii).
|
|
24
|
-
- **Recommended Skill**: `prp-dev-php`
|
|
25
|
-
|
|
26
|
-
---
|
|
27
|
-
|
|
28
|
-
## ๐ ๏ธ Action Flow
|
|
29
|
-
|
|
30
|
-
Upon detecting a Platform:
|
|
31
|
-
1. **Notification**: I will inform you of the detected Stack (e.g., "Detected: Odoo 13 module").
|
|
32
|
-
2. **Mode Switch**: I will instantly harness the knowledge from the relevant specialized Skill to plan (`/30-Plan`) and write code (`/40-Implement`).
|
|
33
|
-
3. **Fallback**: If an unrecognized Stack is spotted, I will ask you for details or default to the standard **Generic Python/JS** pattern.
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
*Developed for Nexus-DevFlow โ Hybrid Development Support*
|