Skip to content

docs: Document direct file editing for Claude in model/workflow skills#264

Merged
stack72 merged 1 commit intomainfrom
docs/claude-direct-file-editing
Feb 10, 2026
Merged

docs: Document direct file editing for Claude in model/workflow skills#264
stack72 merged 1 commit intomainfrom
docs/claude-direct-file-editing

Conversation

@stack72
Copy link
Copy Markdown
Contributor

@stack72 stack72 commented Feb 10, 2026

  • Update swamp-model and swamp-workflow skills to recommend direct file editing
  • Claude can now use the Edit tool on YAML files instead of piping via stdin
  • Workflow: get → Edit tool → validate

Closes #253

- Update swamp-model and swamp-workflow skills to recommend direct file editing
- Claude can now use the Edit tool on YAML files instead of piping via stdin
- Workflow: `get` → Edit tool → `validate`

Closes #253
Copy link
Copy Markdown

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review: ✅ Approved

This is a documentation-only PR that simplifies the "Edit" sections in both swamp-model and swamp-workflow skill files. The changes recommend using Claude's native Edit tool for direct file editing rather than stdin/heredoc patterns.

What was reviewed:

  • Code style compliance: N/A - documentation only, no TypeScript changes
  • DDD principles: N/A - skill instruction files, not domain code
  • Test coverage: N/A - documentation changes don't require tests
  • Security: No concerns - no executable code changes

Observations:

  1. The recommended workflow (get → Edit tool → validate) is clear and consistent across both files
  2. Important warnings (e.g., "Never modify the id field") are preserved
  3. Alternative methods (interactive editor, stdin) remain documented for users who need them
  4. The swamp repo index tip for stale search results is included

The PR achieves its goal of streamlining Claude's workflow for editing model and workflow files while maintaining backward compatibility documentation.

@stack72 stack72 merged commit d9e66f7 into main Feb 10, 2026
4 checks passed
@stack72 stack72 deleted the docs/claude-direct-file-editing branch February 10, 2026 21:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Allow Claude to use raw edits to models + workflows rather than using stdin

1 participant