codemark

Create persistent code bookmarks using tree-sitter AST queries and content hashes.

120|1|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/DanielCardonaRojas/codemark --skill codemark
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codemark
Source: https://github.com/DanielCardonaRojas/codemark/tree/main/extras/skills/codemark
Command: npx skills add https://github.com/DanielCardonaRojas/codemark --skill codemark

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers and AI agents manage and recall important code locations across refactoring, renaming, and reformatting, reducing time spent searching and maintaining context.

Core Features & Use Cases

  • Semantic Search and Resolution: Find and re-identify code snippets based on structure and content hashes, even after changes.
  • Rich Metadata & Annotations: Store detailed context, git history, and multiple notes per bookmark to preserve intent.
  • Use Case: During a complex code review, create bookmarks on critical functions and logic points. After refactoring, quickly locate these bookmarks to verify behaviors or update documentation.

Quick Start

Bookmark a function by range and add notes about its role and dependencies, then retrieve it later during a session.

Frequently Asked Questions about codemark

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bookmark code locations so they survive refactoring and renaming?

Code bookmarking survives refactors by using tree-sitter AST queries and content hashes to persistently identify code locations. This ensures structured markers remain valid and re-identifiable even after renaming or reformatting.

How does AST-based code navigation maintain bookmarks after code changes?

AST-based code navigation maintains bookmarks by resolving code structure through tree-sitter queries and content hashes. It re-identifies code snippets semantically, ensuring bookmarks persist through modifications without relying on fixed line numbers.

Can I add metadata and notes to code bookmarks for collaborative code review?

Yes, you can add rich metadata and annotations to code bookmarks. This stores detailed context, git history, and multiple notes per bookmark, preserving intent and supporting collaborative software engineering tasks.

What is the best way to track critical functions during a complex code review?

The best way to track critical functions is creating structured bookmarks on specific logic points with attached notes. You can retrieve these later to verify behaviors or update documentation after refactoring.

Do I need specific dependencies to use tree-sitter queries for code structure resolution?

No specific dependencies are required to use tree-sitter queries for code structure resolution. The Skill operates independently using its internal scripts and references to parse ASTs and manage persistent code markers.

Why do my standard code bookmarks break after reformatting or renaming?

Standard code bookmarks break because they rely on fixed line numbers or exact text matches. This Skill prevents breakage by using tree-sitter AST queries and content hashes to resiliently re-identify code locations.