pageel/para-workspace/para-kit

Claude Code and agent skill by pageel/para-workspace

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

PARA workspace structure reference — schema, layout, kernel governance, and intelligence routing.

Install

npx vskill@latest install pageel/para-workspace/para-kit

SKILL.md

Skill: PARA Kit

PARA structure reference for AI agents. Use this skill when you need to understand
workspace layout, project.md schema, or kernel governance rules.

1. PARA Workspace Structure

Four Pillars
text
Projects/    — Active work with deadlines or deliverables
Areas/       — Stable knowledge, SOPs, ongoing responsibilities
Resources/   — Reference materials, tools, templates (READ-ONLY for ai-agents/)
Archive/     — Cold storage for completed/cancelled items (never read during normal ops)
Standard Project Layout
text
<project-slug>/           # kebab-case (I3)
├── project.md            # YAML frontmatter contract (see §2)
├── repo/                 # Source code (git-tracked)
├── sessions/             # Daily session logs (YYYY-MM-DD.md)
├── artifacts/
│   ├── tasks/
│   │   ├── backlog.md    # CANONICAL task store (I2)
│   │   ├── sprint-current.md  # Hot Lane (quick tasks)
│   │   └── done.md       # Completed tasks archive (append-only)
│   ├── plans/            # Implementation plans
│   └── para-decisions/   # Decision records
├── docs/                 # Internal documentation
├── .agents/               # Project-specific rules/skills
│   ├── rules.md          # Rules index (trigger table)
│   └── rules/            # Rule files (loaded on-demand)
└── .beads/
    └── seeds.md          # Ideas, hypotheses, raw notes (I7)
Ecosystem Projects (v1.6.0+)
TypePurposeHas repo/Has satellites
standardRegular project (default)YesNo
ecosystemCoordinates satellitesNoYes

Cross-project plan reference: active_plan: "@ecosystem-slug/plans/shared-plan.md"

2. project.md Schema (v1.6.3)

All fields in YAML frontmatter:

FieldTypeRequiredDefaultDescription
goalstring✅—Project objective
deadlinedate❌—Target date (YYYY-MM-DD)
statusenum✅activeactive / paused / done / archived
versionsemver❌—Current project version
strategystring/~✅~Current strategic approach
roadmappath✅—Relative path to roadmap plan
active_planstring❌""Current implementation plan path
csamap❌—CSA configuration map (spec/doc thresholds, gate)
agent.rulesbool✅falseHas project-specific rules?
agent.skillsbool✅falseHas project-specific skills?
typeenum❌standardstandard / ecosystem
ecosystemstring❌—Parent ecosystem slug (satellite)
satelliteslist❌—Child project slugs (ecosystem)
upstreamlist❌—Projects this project depends on
downstreamlist❌—Dependent project slugs
dodlist❌—Definition of Done criteria
milestoneslist❌—Feature-first milestone tracking
tagslist❌—Classification tags
last_revieweddate❌—Last project review date

→ Full template: templates/project-md.md → Test vectors: examples/project-schema-vectors.md

3. Quick Reference Card — Kernel Governance

⚠️ One-liner summary. Full detail → Resources/ai-agents/kernel/invariants.md, heuristics.md
Invariants (MUST — vi phạm = MAJOR bump)
IDNameKey Constraint
I1PARA Directory StructureOnly 4 top-level dirs (PascalCase)
I2Hybrid 3-File Modelbacklog.md = authority, sprint = hot lane
I3Project Namingkebab-case only
I4Project InactivityNo active tasks = inactive, archive = manual
I5Areas No Runtime TasksAreas/ = stable knowledge, not active work
I6Archive Is Cold StorageImmutable, never read during normal ops
I7Seeds Are Raw Ideas.beads/ = ideas, NOT tasks
I8No Loose FilesEvery file belongs to P/A/R/Archive
I9Resource ImmutabilityResources/ai-agents/ = READ-ONLY
I10Repo-Workspace SeparationRepo has no user data, workspace has snapshot
I11Workflow Language ComplianceOutput in preferences.language from .para-workspace.yml
Heuristics (SHOULD — vi phạm = MINOR/PATCH)
IDNameKey Guidance
H1Naming Conventionskebab-case files, PascalCase components
H2Context Loading Priorityproject.md → rules → artifacts → areas
H3VersioningPATCH auto, MINOR/MAJOR ask user
H4Project StructureStandard layout: repo/, sessions/, artifacts/
H5Beads LifecycleCreate → messy → graduate at /retro
H6VCS & Git BoundariesGit only in repo/, not workspace root
H7Cross-Project ReferencesFull relative paths, prefer Resources/
H8Workflow CompatibilityDeclare kernel_compat in catalog.yml
H9Governed Library CatalogsVERSIONS.yml is single source of truth for versions

4. Selection Strategy

Use CLI (./para <cmd>) when:
  • Deterministic operations: install, update, status, archive
  • System maintenance: cleanup, migrate
  • Scripted automation or CI/CD pipelines
Use Workflows (/<cmd>) when:
  • Collaboration & analysis: /brainstorm, /plan, /retro
  • Agent-driven: /open, /end, /backlog, /push
  • Multi-step reasoning: /para-audit, /verify, /release

5. On-demand References

FileContent
templates/project-md.mdFull project.md template with all v1.6.3 fields
examples/project-schema-vectors.mdTest vectors for schema validation
Rules (formatting, versioning, governance) → .agents/rules/ (loaded via trigger from .agents/rules.md)
Full kernel → Resources/ai-agents/kernel/ (read only during /para-audit, /plan, or scaffolding)

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
45
Repository forks
18
7-day trend score
19

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/pageel/para-workspace/para-kit/badge)](https://verified-skill.com/skills/pageel/para-workspace/para-kit)

Something wrong with this skill or its page? Tell us.