setup-lidessen-skills
Setup lidessen skills
Operational deployer for the lidessen skills collection. The lidessen methodology lives in the individual skills (harness, design-driven, goal-driven, reframe, evidence-driven, etc.); this skill does the wiring to land them in a target project — detect the host tool, write to the right harness file, and inject the cross-cutting principles that span multiple lidessen skills.
Position relative to harness
harness (and any general-purpose harness skill) teaches how to think about agent context — portable methodology, applies to any project regardless of skill collection. This skill is the lidessen-specific operational layer that applies harness-style structure to a project adopting the lidessen collection. Read harness for the why; run this skill to do the wiring.
Boundary — what this skill does and doesn't
Does:
- Detect host tool (Claude Code / Codex / Cursor / other) by config-file presence
- Create or update the project's harness config with a delimited "Lidessen" section
- Inject canonical cross-cutting principles from
references/cross-cutting-principles.md - Maintain a version marker so subsequent
sync/auditruns can detect drift
Doesn't:
- Teach lidessen methodology (each skill's own SKILL.md owns that)
- Copy or install skill files (use clone / symlink / your package manager)
- Modify per-skill content (each skill is its own concern)
Tool detection
Detect host tool in priority order before any subcommand writes:
CLAUDE.mdexists at project root → Claude CodeAGENTS.mdexists at project root → Codex.cursor/directory exists → Cursor- None of the above → ask the user explicitly which tool they're configuring
The detected tool determines the target file:
| Tool | Target file |
|---|---|
| Claude Code | CLAUDE.md |
| Codex | AGENTS.md |
| Cursor | .cursor/rules/lidessen.md (created if missing) |
| Other | ask the user where to write |
If multiple host configs are present, prefer the one the user names; fall back to priority order.
Delimited section format
The lidessen-managed content lives inside paired markers so reruns can replace cleanly without disturbing surrounding content:
<!-- lidessen-setup:begin v=<N> -->
... lidessen-managed content ...
<!-- lidessen-setup:end -->
Invariant: content outside the markers belongs to the user and must never be touched. Content inside the markers is wholly owned by this skill and is replaced on every sync. Users who need to override a principle should do so outside the markers — typically by adding a contrary note in their own section that consumers of CLAUDE.md will read alongside.
Subcommands
Dispatch by argument:
init— Scaffold the lidessen section in a project that doesn't yet have one. Seecommands/init.md.sync— Replace the lidessen section with current canonical content; bumps version. Seecommands/sync.md.audit— Read-only drift check; never writes. Seecommands/audit.md.
If invoked with no argument, default to audit — it is the safe read-only operation and surfaces enough information for the user to decide whether they want init or sync.
Principal contradiction (this skill)
Per the canonical principle — the load-bearing decision in this skill is what gets injected (the canonical content in references/cross-cutting-principles.md). Tool detection, marker format, subcommand split are all secondary; getting them wrong is locally repairable, but injecting the wrong content propagates into every consumer project. Treat references/cross-cutting-principles.md with the discipline due a public API.
More from lidessen/skills
memory
Manages cross-session knowledge persistence. Triggers on "remember", "recall", "what did we", "save this decision", "todo", or session handoff.
82design-driven
Design-driven development methodology — the design/ directory is the single source of architectural truth; read it before coding, stay within its boundaries, and update it first when the system's shape changes. Use whenever starting development on this project, or when the user asks to create/update architecture docs, add a feature that may cross existing boundaries, refactor system structure, or understand the codebase architecture. Triggers on "design first", "update the design", "does this change the architecture", "write a design for", "what's the current design", or onboarding to a codebase's shape. Args — `/design-driven init` to configure a project, `bootstrap` to generate design from existing code, `audit` to reconcile design/ against current code.
23harness
Agent harness architecture — structure a project's agent context across layers for effective AI-assisted development. Covers CLAUDE.md, skills, design docs, hooks, and all artifacts that shape how an agent understands and operates in a codebase. Use when setting up or improving agent configuration, when agent context feels bloated or disorganized, when onboarding a project for AI-assisted development, or when the agent keeps losing architectural awareness mid-task. Triggers on "set up claude", "improve CLAUDE.md", "agent keeps forgetting", "context is too long", "harness setup", "organize agent context", "how should I structure my prompts". Args — `/harness audit` to evaluate an existing project's context architecture, `init` to set up harness from scratch.
19housekeeping
Manages project housekeeping including documentation organization, dependency management, directory structure, code cleanup, technical debt tracking, and infrastructure configuration. Use when organizing documentation, cleaning up dependencies, reorganizing folders, removing dead code, addressing tech debt, or maintaining project structure.
18validation
Unified validation orchestration for code quality, consistency, and project health. Auto-triggers on code changes, PR creation, or explicit validation requests. Coordinates refining, housekeeping, and custom validators into cohesive pipelines. Use for "validate", "check", "verify", "验证", "检查", or when quality assurance is needed.
17orientation
Orients agents in new projects by scanning entry documents and discovering capabilities. Use at session start, when entering unfamiliar territory, or when asking "what can you do" or "where do I start".
16