openalmanac 0.2.39 → 0.2.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openalmanac",
-  "version": "0.2.39",
+  "version": "0.2.41",
   "description": "OpenAlmanac — pull, edit, and push articles to the open knowledge base",
   "type": "module",
   "bin": {

package/skills/reddit-wiki/SKILL.md

@@ -156,24 +156,42 @@ Read 20-30 corpus entries (prioritize high-score posts) to understand the landsc
 list_articles(community_slug: "<subreddit>", sort: "most_referenced")
 ```
 
-Identify 15-20 core topics grouped by theme. These should be the foundational articles every reader of this wiki would expect. Present them to the user grouped by theme:
+Identify 15-20 core articles. **Favor nouns over themes** — specific things people would look up, not vague survey topics.
+
+- **~70% nouns:** Specific locks, tools, people, techniques, concepts. "American Lock 1100", "Spool Pin", "Tension Wrench", "LockPickingLawyer". These are the building blocks — what people search for, link to, and learn from.
+- **~30% structural themes:** Only the big ones that serve as entry points and tie nouns together. "Belt System", "Lock Picking Basics". Not vague surveys — each should be a real article that teaches something.
+
+Bad: "Security Pin Mechanics" (vague theme, reads like a textbook chapter)
+Good: "Spool Pin", "Serrated Pin", "Mushroom Pin" (specific nouns — then link them from a "Security Pins" overview)
+
+Present them to the user grouped by category, but make clear most articles are about specific things:
 
 ```
 Here's what I'd build for the foundation:
 
-  Lock Anatomy
-    › Cylinder, Warding, Master Keying
+  Locks
+    › American Lock 1100, Abus 55/40, Master Lock #3, Kwikset SmartKey
+
+  Components
+    › Spool Pin, Serrated Pin, Tension Wrench, Key Pin
 
   Techniques
-    › Bumping, Comb Picking, Impressioning
+    › Bumping, Raking, Single Pin Picking
 
-  [etc.]
+  Community
+    › LockPickingLawyer, BosnianBill, Belt System
 
 Want to add or change anything?
 ```
 
 Include your recommendation. Wait for the user to confirm or adjust.
 
+### Topics
+
+The groupings you present (Locks, Components, Techniques, Community) become **community topics** on Almanac. Topics show up as categories on the wiki page and each article gets assigned to one. When you scaffold articles, include the topic in the `new()` call.
+
+Keep topics broad and few (4-7). They're navigation, not a taxonomy. A topic like "Locks" is good. A topic like "European High-Security Disc Detainer Locks" is too specific — that's an article, not a topic.
+
 ### Scaffold entities
 
 Before any writing, scaffold all planned articles as local files:
@@ -357,6 +375,11 @@ openalmanac.org/communities/<subreddit>/wiki
 - The description should have personality — capture the community's vibe, not a generic taxonomy
 - Find a good cover image with `search_images`
 
+### File access
+- Use `Glob` and `Read` tools to browse and read files in `~/.openalmanac/` — do NOT use `Bash(ls ...)` or `Bash(cat ...)`
+- Use `Write` and `Edit` tools to modify files — do NOT use `Bash(echo ...)` or `Bash(sed ...)`
+- The only Bash command you should use is the ingest script
+
 ### What NOT to do
 - Don't estimate how long things will take
 - Don't make small talk or ask personal questions