Skill

Waymark CLI

This skill should be used when the user asks about "wm command", "waymark cli", "wm find", "wm add", "wm edit", "wm rm", "wm fmt", "wm lint", or needs to use waymark tooling. Requires `using-waymarks` skill for syntax fundamentals. Provides comprehensive CLI command reference and workflows.

From waymark
Install
1
Run in your terminal
$
npx claudepluginhub outfitter-dev/waymark
Tool Access

This skill uses the workspace's default tool permissions.

Supporting Assets
View in Repository
commands/add.md
commands/check.md
commands/config.md
commands/doctor.md
commands/edit.md
commands/find.md
commands/fmt.md
commands/help.md
commands/init.md
commands/lint.md
commands/rm.md
commands/seed.md
commands/update.md
examples/agent-tasks.md
examples/auditing.md
examples/batch-operations.md
examples/integration.md
examples/workflows.md
manifest.json
references/errors.md
Skill Content
<!-- tldr ::: core skill documentation for waymark CLI agents -->

Waymark CLI Skill

Prerequisite

Load the using-waymarks skill first for grammar and syntax fundamentals. This skill focuses on CLI commands and workflows, assuming familiarity with waymark syntax.

Load first: using-waymarks covers grammar, markers, TLDRs, and ripgrep patterns.

When to Use This Skill

  • Find existing waymarks and summarize project status.
  • Add new TODOs, TLDRs, or notes while implementing changes.
  • Edit signals (flagged/starred) or content in place.
  • Remove completed waymarks with audit history.
  • Format or lint waymarks for consistency in CI.

Command Overview

CommandPurposeExample
findScan and filterwm find src/ --type todo --json
addInsert waymarkswm add src/auth.ts:42 todo "add retry"
editModify waymarkswm edit src/auth.ts:42 --flagged
rmRemove waymarkswm rm src/auth.ts:42 --write
fmtFormat waymarkswm fmt src/ --write
lintValidate structurewm lint src/ --json
initWrite configwm init --format toml
configPrint configwm config --print --json
skillShow skill docswm skill show add
updateUpdate CLIwm update --yes
doctorDiagnose configwm doctor --json
helpShow CLI helpwm help add

Quick Start Patterns

  • Find open work: wm find src/ --type todo --json
  • Add a tldr for a new file: wm add src/new.ts:1 tldr "summary"
  • Flag a waymark during a refactor: wm edit src/auth.ts:42 --flagged --write
  • Remove completed work safely: wm rm src/auth.ts:42 --write

Output Formats

  • Default: human-readable text
  • --json: JSON array (best for parsing)
  • --jsonl: JSON lines (streaming)

Safety Model

  • Most commands preview by default.
  • Use --write to apply changes.
  • --no-input fails fast in CI if prompts are required.

Exit Codes

CodeMeaning
0Success
1Waymark error
2Usage error
3Configuration error
4I/O error

Getting More Help

  • Command docs: wm skill show <command>
  • References: wm skill show schemas or wm skill show exit-codes
  • Skill format: wm skill show skill-format
  • Project-specific skills: wm skill show project-skills
  • Examples: wm skill show workflows
  • CLI help: wm <command> --help

Related Skills

  • using-waymarks - Grammar, syntax, markers, TLDRs, and ripgrep patterns (load first)
Similar Skills
cache-components

Expert guidance for Next.js Cache Components and Partial Prerendering (PPR). **PROACTIVE ACTIVATION**: Use this skill automatically when working in Next.js projects that have `cacheComponents: true` in their next.config.ts/next.config.js. When this config is detected, proactively apply Cache Components patterns and best practices to all React Server Component implementations. **DETECTION**: At the start of a session in a Next.js project, check for `cacheComponents: true` in next.config. If enabled, this skill's patterns should guide all component authoring, data fetching, and caching decisions. **USE CASES**: Implementing 'use cache' directive, configuring cache lifetimes with cacheLife(), tagging cached data with cacheTag(), invalidating caches with updateTag()/revalidateTag(), optimizing static vs dynamic content boundaries, debugging cache issues, and reviewing Cache Component implementations.

138.5k
Stats
Stars1
Forks0
Last CommitJan 17, 2026