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/iterate
tools
VerifiedTrustedCommunity
Iterate on a GitHub pull request — drive it through CI, code review, and QA until it is merge-ready. Poll verification layers with `gh` CLI, diagnose and fix CI failures, address review feedback, retry flaky checks, push fixes, and repeat. The agent is the orchestration loop.
125SKILL.mdUpdated Apr 18, 2026
openhands/technical-writing
development
VerifiedTrustedCommunity
Guides technical explanations toward flowing, direct, conversational prose. This skill should be used for engineering chat, design discussion, architecture analysis, code-review explanations, and technical recommendations that should be concise without becoming fragmented or vague.
124SKILL.mdUpdated Jul 13, 2026
openhands/jira-issue-to-pr
tools
VerifiedTrustedCommunity
This skill should be used when the user asks to "set up a Jira automation to create pull requests", "poll Jira for create-pr issues", "automatically create GitHub PRs from Jira tickets", "deploy a Jira issue-to-PR automation", "create a Jira to GitHub PR workflow", or mentions automating GitHub PR creation from a Jira label. Deploys a cron-based OpenHands automation that watches a Jira Cloud project for issues labeled with a configurable label (default: "create-pr") and spawns an agent conversation to create a GitHub pull request for each new issue found. The target GitHub repository is read from the body of the Jira ticket - no repo parameter is required at deploy time.
123SKILL.mdUpdated Jul 7, 2026
openhands/openhands-automation
tools
VerifiedTrustedCommunity
This skill should be used when the user asks to "create an automation", "schedule a task", "set up a cron job", "webhook integration", "event-triggered automation", or mentions automations, scheduled tasks, cron scheduling, or webhook events in OpenHands Cloud.
123SKILL.mdUpdated Apr 24, 2026