openhands/cobol-modernization
plugins/cobol-modernization/skills/cobol-modernization-overview/SKILL.md
End-to-end COBOL to Java migration workflow. Handles build setup, mainframe dependency removal, and code migration with test validation.
$ install --global
skillsauthnpx skillsauth add openhands/extensions cobol-modernizationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 10, 2026, 9:17 AM28.9s1 file scanned
SKILL.md
- name:
- cobol-modernization
- description:
- End-to-end COBOL to Java migration workflow. Handles build setup, mainframe dependency removal, and code migration with test validation.
- license:
- MIT
- compatibility:
- Requires GnuCOBOL, Java 11+, Maven/Gradle, Python 3.13 with uv
End-to-end workflow for migrating COBOL codebases to Java.
Overview
This plugin orchestrates a multi-phase COBOL modernization project:
- Build Setup — Configure compilation for both COBOL and Java, create test fixtures
- Mainframe Planning — Document transformations needed to remove mainframe dependencies
- Mainframe Removal — Convert CICS/VSAM code to standard COBOL
- Java Migration — Translate standardized COBOL to idiomatic Java
Prerequisites
- GnuCOBOL compiler (
cobc) - Java 11+ with Maven or Gradle
- Python 3.13 with
uv - LLM API key (Anthropic or OpenAI)
Quick Start
export LLM_API_KEY="your-api-key"
export LLM_MODEL="anthropic/claude-3-5-sonnet-20241022"
uv run python -m lc_sdk_examples.cobol_modernization --src-path /path/to/cobol/project
Workflow Phases
Phase 1: Build Setup
See ../build-setup/SKILL.md
Creates the foundation for the migration:
- COBOL compilation environment (GnuCOBOL)
- Java project structure (Maven/Gradle + JUnit 5)
- Test fixtures with golden outputs from COBOL execution
Outputs:
build_notes.md— Build instructionstest-fixtures/— Input/output test datatest_manifest.json— Test case mapping
Phase 2: Mainframe Planning
See ../mainframe-planning/SKILL.md
Creates a transformation guide without modifying code:
- Maps CICS/VSAM constructs to standard COBOL equivalents
- Documents error handling replacements
- Identifies UI operations to stub
Output:
mainframe_dependency_removal_plan.md
Phase 3: Mainframe Removal
See ../mainfraime-removal/SKILL.md
Applies the transformation guide:
- Replaces EXEC CICS commands with file I/O
- Adds FILE STATUS checking
- Stubs BMS/screen operations
Verification:
- Code compiles with GnuCOBOL
- Runs with test fixtures
Phase 4: Java Migration
See ../to-java-migration/SKILL.md
Translates to idiomatic Java:
- Proper Java conventions (not literal translations)
- JUnit tests using golden outputs
- COBOL references in comments
Done when:
- All code compiles
- All JUnit tests pass
- No TODOs or stubs remain
Output Structure
your-project/
├── .lc-sdk/
│ ├── initial_batch_graph.json
│ ├── fixed_batch_graph.json
│ └── mainframe_dependency_removal_plan.md
├── test-fixtures/
│ ├── inputs/
│ └── expected_outputs/
├── test_manifest.json
├── src/main/java/
└── src/test/java/
Troubleshooting
See ../../references/troubleshooting.md for common issues and solutions.
Related Skills
openhands/github-pr-reviewer
tools
VerifiedTrustedCommunity
Create an automation that reviews GitHub pull requests when a configurable trigger label is applied. Polls GitHub deterministically, starts one OpenHands review conversation per label event, inspects full repository and PR context, and posts the final review comment back to GitHub.
112SKILL.mdUpdated Jun 5, 2026
openhands/slack-channel-monitor
tools
VerifiedTrustedCommunity
This skill should be used when the user asks to "monitor a Slack channel", "watch Slack for messages", "create a Slack bot that responds to mentions", "set up an OpenHands Slack integration", "trigger OpenHands from Slack", "respond to @openhands in Slack", or "poll Slack channels for a trigger phrase". Guides the user through creating a cron automation that watches up to 10 Slack channels and starts an OpenHands conversation whenever a configurable trigger phrase is detected.
112SKILL.mdUpdated May 23, 2026
openhands/openhands-sdk
tools
VerifiedTrustedCommunity
Reference skill for the OpenHands Software Agent SDK - the Python framework for building AI agents that write software. Use when you need to build agents with the SDK, create custom tools, configure LLMs, manage conversations, delegate to sub-agents, or deploy agents locally or remotely.
112SKILL.mdUpdated Apr 24, 2026
openhands/github-repo-monitor
tools
VerifiedTrustedCommunity
This skill should be used when the user asks to "monitor a GitHub repository", "watch GitHub for issues or PRs", "respond to @OpenHands mentions on GitHub", "set up an OpenHands GitHub integration", "trigger OpenHands from a GitHub comment", or "poll a GitHub repo for a trigger phrase". Guides the user through creating a cron automation that polls a single repository and starts an OpenHands conversation whenever a configurable trigger phrase is detected in an issue or PR comment.
110SKILL.mdUpdated May 23, 2026