You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix: reference positioning doc from prisma/ignite instead of vendored copy
Update the blog skill to fetch the positioning document from its
authoritative source in prisma/ignite (docs/prisma/positioning.md)
instead of referencing a local vendored copy at assets/positioning.md.
Changes:
- SKILL.md: Assets section now points to raw GitHub URL for prisma/ignite
- SKILL.md: Step 2 and reviewer lens include explicit fetch URL
- SKILL.md: Anti-pattern section references ignite repo source
- README.md: Note updated to reflect new source location
- .gitignore: Removed gitignore entry for vendored positioning doc
Copy file name to clipboardExpand all lines: .claude/skills/README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,7 +33,7 @@ Produces a blog-post **skeleton** (frontmatter, section headings, short stubs),
33
33
5. It writes the skeleton, then adds contextual links: the first mention of Prisma Postgres, Prisma Compute, and Prisma Next links to docs for SEO, and topic mentions cross-link to related posts (for example, a bloom-filter mention links to the bloom-index post).
34
34
6. It hands back a link inventory and a next-step reminder. You flesh out the prose and open a draft PR.
35
35
36
-
**Note:** the skill reads `content-write-blog/assets/positioning.md`, Prisma's internal positioning doc. It is**not committed to this public repo** (it's gitignored). Place it locally before drafting, or the skill will ask for it.
36
+
**Note:** the skill reads the positioning doc from the**prisma/ignite** repository at `docs/prisma/positioning.md` (fetched at draft time from `https://raw.githubusercontent.com/prisma/ignite/main/docs/prisma/positioning.md`). There is no local vendored copy in this repo.
Copy file name to clipboardExpand all lines: .claude/skills/content-write-blog/SKILL.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ The blog is owned by DevRel but contributed to by everyone, so do not assume the
15
15
16
16
## Assets
17
17
18
-
-`assets/positioning.md`— Prisma's internal positioning doc. It is **not committed to this public repo** (it's gitignored); obtain it from the internal positioning source and place it at `assets/positioning.md` before drafting. Read it before writing the lead and section stubs so the angle, framing, and product claims stay aligned with how Prisma describes itself. It is the source of truth for positioning, so do not contradict it. If it is absent, ask the operator for the current positioning before grounding the post.
18
+
-**Positioning doc** — The authoritative source is `docs/prisma/positioning.md`in the **prisma/ignite** repository on GitHub. Fetch it at draft time from its raw URL: `https://raw.githubusercontent.com/prisma/ignite/main/docs/prisma/positioning.md`. Do **not** look for a local copy — there is no vendored version in this repo. Read it before writing the lead and section stubs so the angle, framing, and product claims stay aligned with how Prisma describes itself. It is the source of truth for positioning, so do not contradict it. If the fetch fails, ask the operator for the current positioning before grounding the post.
19
19
20
20
## Asking the operator questions
21
21
@@ -35,7 +35,7 @@ Do not proceed without input, and do not invent a pitch on the operator's behalf
35
35
36
36
## Step 2: Ground in positioning
37
37
38
-
Read the positioning asset above. Note the product names, claims, and framing that the post must stay consistent with. If the pitch conflicts with positioning, surface the conflict to the operator before drafting — do not silently "correct" the pitch, and do not write copy that contradicts positioning.
38
+
Fetch and read the positioning doc from `https://raw.githubusercontent.com/prisma/ignite/main/docs/prisma/positioning.md` (the authoritative copy in the prisma/ignite repo). Note the product names, claims, and framing that the post must stay consistent with. If the pitch conflicts with positioning, surface the conflict to the operator before drafting — do not silently "correct" the pitch, and do not write copy that contradicts positioning.
39
39
40
40
## Step 3: Locate the blog repository checkout
41
41
@@ -164,7 +164,7 @@ Spawn one reviewer agent per applicable lens, every lens that applies, regardles
164
164
-**Fact refuter**: attack every number, price, version, date, and named behavior. Verify each against the live primary source (vendor pricing page, official docs), not from memory. Report any claim whose source does not say what the post says.
165
165
-**Code refuter** (posts with code): run every sample fresh against the stated versions. Report anything that does not compile, run, or produce the shown output.
166
166
-**Reader skeptic**: where does the post confuse, overclaim, contradict itself, or read like marketing? Where would a knowledgeable reader stop trusting it?
167
-
-**Positioning refuter**: report claims that contradict the positioning doc or overstate product status (GA claims, superlatives, unverified benchmarks).
167
+
-**Positioning refuter**: report claims that contradict the positioning doc (fetched from `https://raw.githubusercontent.com/prisma/ignite/main/docs/prisma/positioning.md`) or overstate product status (GA claims, superlatives, unverified benchmarks).
168
168
4.**The implementer fixes; reviewers re-review.** Findings come back to the authoring session, which applies fixes. Re-run the reviewers on the fixed draft. Repeat until a round produces no confirmed findings. The implementer never marks its own finding as resolved without a reviewer pass confirming it.
169
169
170
170
### Completion criterion
@@ -187,7 +187,7 @@ The lead you draft, and the prose the author later writes over your stubs, ship
187
187
-**Writing finished prose.** This skill produces a skeleton. Long generated paragraphs defeat the point and dilute the author's voice. Stubs and section headings only.
188
188
-**Performing the repository workflow.** This skill does not branch, commit, push, or open pull requests. Producing those is the operator's job — stop at writing content into their checkout and handing off.
189
189
-**Hardcoding blog conventions.** The repo evolves. Always discover frontmatter shape, slug rules, blog directory, author shape, and the formatting step from the operator's checkout in Step 4.
190
-
-**Contradicting positioning.** Read the positioning asset first. Do not write claims or framing that conflict with how Prisma describes itself; surface conflicts instead of papering over them.
190
+
-**Contradicting positioning.** Read the positioning doc (fetched from the prisma/ignite repo) first. Do not write claims or framing that conflict with how Prisma describes itself; surface conflicts instead of papering over them.
191
191
-**Skipping the author profile step for first-time contributors.** The missing profile is a common trip-wire. Surface it and scaffold it alongside the post.
192
192
-**Inventing the pitch.** If the operator gave no direction, ask. Do not generate a topic from imagination.
193
193
-**Over-linking.** Adding links to every proper noun, tangential reference, or vaguely related page produces a link farm, not a useful post. Link only when the reader genuinely benefits. If in doubt, leave it out — the operator can always add links later. The one exception is the first mention of Prisma Postgres, Prisma Compute, and Prisma Next: always link those to docs for SEO.
0 commit comments