lynx-debug

Lynx Agent Skills

A collection of Agent skills for Lynx.

Available Skills

reactlynx-best-practices

ReactLynx best practices covering patterns writing dual-threaded React code with ReactLynx. Provides rules reference for writing, static analysis for reviewing, and auto-fix for refactoring.

Use when:

• Writing new ReactLynx components or applications
• Reviewing existing ReactLynx code for issues
• Refactoring ReactLynx code with auto-fixes

Rules covered:

Rule	Impact	Description
detect-background-only	Critical	Native APIs in background contexts
proper-event-handlers	Medium	Correct event handler usage
main-thread-scripts-guide	Medium	Main thread scripts guide
hoist-static-jsx	Low	Performance optimization

debug-info-remapping

Remap Lynx main-thread runtime error positions to original source code locations using debug info.

Use when:

• Debugging main thread runtime errors with function_id:pc_index format
• Working with Lynx bytecode stack traces
• Need to locate the actual source position from encoded error messages

trace-analysis

Analyze Lynx performance traces (.ptrace files) to identify bottlenecks in rendering pipelines.

Use when:

• Analyzing performance of Lynx applications
• Diagnosing rendering delays and bottlenecks
• Understanding Lynx pipeline execution flow
• Automated performance reporting / regressions detection with Agents

lynx-devtool

Interact with Lynx DevTool to inspect and debug Lynx applications via the CLI. Supports sending CDP commands, App commands, opening URLs, reading console logs, listing sources, and taking screenshots on connected devices.

Use when:

• Inspecting DOM, runtime state, or console output of a running Lynx app
• Sending Chrome DevTools Protocol (CDP) or App commands to a connected device
• Automating debugging workflows like taking screenshots or opening URLs in Lynx

Installation

npx skills add lynx-community/skills

Contributing

[!IMPORTANT] Pull requests must target the main branch, not the release branch.

See CONTRIBUTING.md for development setup, project structure, and guidelines on creating new skills and plugins.

Credits

Thanks to:

• Anthropic Skills for creating the Agent Skills standard and providing excellent skill examples that inspired this project's structure and patterns.
• Vercel React Best Practices for inspiring the rule-based skill structure and providing comprehensive React performance optimization guidelines for the web ecosystem.
• Vercel Skills CLI for providing the open agent skills CLI that helps distribute skills across coding agents.