deck editor
Transactional file editing with atomic operations, dry-run previews, and revision-tracking via Deck MCP.
Free
Works with the AI Agents you already use
deck editor
Example session with this skill installed
Replace the calculate function on lines 10-12 in src/math.py with a new version that returns 42. Use the revision hash a1b2c3d4e5f6.
- Read your context and instructions
- Compiled the deck editor
I will replace the function in src/math.py using a transactional deck to ensure the edit is applied to the correct file version.
File Update: src/math.py
@APPLY a1b2c3d4e5f6
@REPLACE 10-12
def new_calculate():
return 42
@END
Response from Deck MCP:
APPLIED successfully
REV: b2c3d4e5f6a1b2c3 (new)
Operations applied:
- REPLACE lines 10-12 (3 lines replaced with 2 lines)
Next steps
- Run
deck_getonsrc/math.pyfor lines 10-11 to verify the new content. - Execute your test suite to ensure the logic change didn't break dependencies.
- Save the new revision hash
b2c3d4e5f6a1b2c3for any subsequent edits.
Connects securely to your tools. The creator never sees your data.
About this skill
Editing large files via LLM often leads to truncated code or hallucinated line numbers. This skill provides a transactional editing interface using the Deck MCP server, ensuring file modifications are atomic and revision-aware.
What it does
- Atomic Operations ensures that multi-line edits either succeed entirely or fail without partial writes.
- Revision Tracking uses unique hashes to prevent overwriting concurrent changes or applying edits to stale context.
- Dry-run Preview allows verification of complex diffs before committing changes to disk.
- RegEx Substitution enables sed-style pattern replacement across specified line ranges.
- Conflict Detection identifies version mismatches and out-of-range addresses to prevent file corruption.
How it works
- Read and Sync by calling
deck_getto retrieve the current file content and its unique revision hash. - Construct Deck by defining operations like
REPLACE,DELETE, orINSERTtargeting specific line numbers. - Validate with
@DRYto receive a preview diff of the proposed changes. - Commit using
@APPLYwith the matching revision hash to write changes to the filesystem.
Frameworks & tools
This skill requires the Deck MCP server. It integrates with standard development workflows using ripgrep or ast-grep for initial target discovery.
Why this beats prompting it yourself
Standard prompting relies on the LLM to rewrite entire files or provide search-and-replace blocks that often fail on indentation or repetitive code. This skill enforces a strict grammar with revision checks, making it impossible to accidentally corrupt a file due to stale context.
Use cases
- Refactoring large functions where only specific line ranges need modification.
- Automating bulk text replacements across files using regex patterns.
- Appending log entries or configuration lines to the end of existing files.
- Safe insertion of decorators or shell variables that use reserved characters.
Known limitations
Does not validate language-specific syntax after editing. Requires an active Deck MCP server connection and valid revision hashes for all apply operations.
Requires Deck MCP server. Does not validate code syntax. Revision hashes are mandatory for existing file edits. Multi-operation decks must manually recompute line shifts.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 6 days ago
- Free with an Agensi account
Requires