Hedera Hackathon Submission Validator — Claude Code skill
Hedera Hackathon Submission Validator audits your Hedera hackathon repository, scores it against official judging criteria, and lists prioritized improvements.
Apache-2.0 690 installs ★ 37 updated 2026-09-03
npx skills add hedera-dev/hedera-skills --skill hedera-hackathon-submission-validator -a claude-codeWhat Hedera Hackathon Submission Validator does
The skill inspects project files, dependency configs like package.json or Cargo.toml, and repository documentation. It looks for Hedera SDK imports, HTS precompiles at 0x167, HCS calls, and mirror node endpoints.
It evaluates submissions across seven categories: execution (20%), network success (20%), integration depth (15%), validation (15%), feasibility (10%), innovation (10%), and pitch (10%). Each item receives a score from 1 to 5, feeding into a weighted final grade.
Reviews rely strictly on repository contents. If user feedback, traction metrics, or token designs are missing from Markdown files or source code, validation and feasibility scores drop immediately.
What it helps with
- audit a hackathon codebase before final submission
- evaluate the depth of Hedera SDK and service usage
- identify missing tests and architecture documentation
- generate a prioritized list of high-impact fixes
Example prompts for the agent
- Review my hackathon project and generate a scorecard
- Check submission readiness for the Hedera hackathon
- Score my Hedera hackathon code and show the top 5 improvements
How to install Hedera Hackathon Submission Validator
1Skills CLI (Vercel)
npx skills add hedera-dev/hedera-skills --skill hedera-hackathon-submission-validator -a claude-code2Manually: put the files in place
~/.claude/skills/validate-submission/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/validate-submission/
1Skills CLI (Vercel)
npx skills add hedera-dev/hedera-skills --skill hedera-hackathon-submission-validator -a codex2Manually: put the files in place
.agents/skills/validate-submission/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hedera-dev/hedera-skills --skill hedera-hackathon-submission-validator -a cursor2Manually: put the files in place
.cursor/skills/validate-submission/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hedera-dev/hedera-skills plugins/hackathon-helper/skills/validate-submission2Manually: put the files in place
.github/skills/validate-submission/SKILL.md1Skills CLI (Vercel)
npx skills add hedera-dev/hedera-skills --skill hedera-hackathon-submission-validator -a gemini-cli2Platform CLI
gemini skills install https://github.com/hedera-dev/hedera-skills --path plugins/hackathon-helper/skills/validate-submissionManually: put the files in place
.devin/skills/validate-submission/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hedera-dev/hedera-skills --skill hedera-hackathon-submission-validator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about Hedera Hackathon Submission Validator
How to install Hedera Hackathon Submission Validator in Claude Code?
Run npx skills add hedera-dev/hedera-skills --skill validate-submission -a claude-code in your project terminal.
What does Hedera Hackathon Submission Validator do?
It audits the codebase against seven hackathon criteria, assigns 1 to 5 points per category, and outputs a weighted scorecard with actionable recommendations.
How does the validator judge Hedera integration depth?
It gives 1 point for plain mirror node queries, 2 to 3 points for a single service, and up to 5 points when multiple services connect with ecosystem partners.
Source text
SKILL.md · Apache-2.0
--- name: Hedera Hackathon Submission Validator description: This skill should be used when the user wants to validate, review, or score their Hedera hackathon submission before submitting. Triggered by phrases like "validate hackathon submission", "review my hackathon project", "hackathon scorecard", "check submission readiness", "score my hackathon", "submission review", "judge my project", "hackathon submission quality", or "improve hackathon score". --- # Hedera Hackathon Submission Validator Review a Hedera hackathon submission's codebase and score it against the official judging criteria. Focus on what is observable from the code, README, and documentation in the repository. ## Step 1: Discover the Project Scan the codebase to understand what was built: 1. Read the README.md (or equivalent) for project overview 2. Identify the tech stack: - `package.json`, `Cargo.toml`, `go.mod`, `requirements.txt`, etc. - Look for Hedera SDK dependencies (`@hashgraph/sdk`, `hedera-sdk-*`, etc.) 3. Find Hedera integration points: - Search for Hedera SDK imports and usage - Search for HTS precompile addresses (`0x167`) - Search for Hedera service calls (token create, consensus submit, etc.) - Search for mirror node API calls - Search for ecosystem integrations (wallet connect, DEX, etc.) 4. Assess project structure and code quality 5. Look for documentation: architecture docs, design decisions, business model, pitch materials 6. Check for tests and CI/CD configuration ## Step 2: Score Against Each Criterion Evaluate the submission against each of the 7 judging criteria. For each, provide a score (1-5), evidence from the codebase, and specific improvement suggestions. Refer to `references/judging-criteria.md` for the complete rubric with guiding questions and 1/3/5 score descriptors. ### Innovation (10% weight) Review for: - Is this a novel solution or a clone of existing platforms? - Does it introduce new capabilities to the Hedera ecosystem? - Does the README explain what makes it unique? - Check if similar projects exist (based on what you can infer from the code) ### Feasibility (10% weight) Review for: - Is the solution technically sound? - Does it genuinely require Web3/blockchain? Or could this work on Web2? - Is there a business model documented? (Lean Canvas, monetization strategy) - Does the code demonstrate domain understanding? ### Execution (20% weight) - HIGHEST PRIORITY Review for: - **Completeness**: Is this a working MVP, PoC, or just scaffolding? - **Code quality**: Clean architecture, error handling, testing? - **UI/UX**: If there's a frontend, is it polished or rough? - **Documentation**: README completeness, setup instructions, architecture docs - **Design decisions**: Are key technical choices documented and justified? - **Strategy**: Is there a roadmap or post-hackathon plan? - **GTM**: Is there a go-to-market strategy documented? ### Integration (15% weight) - HIGH PRIORITY Review for: - **Services used**: Which Hedera services are actually integrated? (HTS, HCS, Smart Contracts, HFS, Scheduled Transactions) - **Integration depth**: Is it meaningful usage or superficial? (e.g., just mirror node queries = shallow) - **Ecosystem partners**: Are any ecosystem platforms integrated? (SaucerSwap, HashPack, etc.) - **Creativity**: Is any Hedera service used in a non-obvious way? - **Multiple services**: Are multiple Hedera services combined? Rate integration depth: - Mirror node queries only = 1 point - Single service, obvious usage = 2-3 points - Multiple services, meaningful usage = 3-4 points - Multiple services + ecosystem partners + creative usage = 5 points ### Validation (15% weight) Review for: - Is there evidence of external user testing? (feedback docs, user survey results, analytics) - Are market feedback cycles documented? - Is there any traction data? (user counts, sign-ups, etc.) - Note: This is hard to assess from code alone. Flag if no evidence is found. ### Success (20% weight) - HIGHEST PRIORITY Review for: - Does the solution architecture drive Hedera account creation? - Would usage generate meaningful TPS on the network? - Does it expose Hedera to new audiences? - Is the potential network impact documented or estimable from the code? ### Pitch (10% weight) Review for: - README quality as a proxy for pitch quality - Is the problem/solution clearly explained? - Are metrics and market data cited? - Is Hedera's role clearly articulated? - Is there a pitch deck or demo script in the repo? ## Step 3: Generate the Scorecard Output a comprehensive report: ```markdown # Hackathon Submission Review ## Project Summary - **Name**: [from README] - **Description**: [1-2 sentences] - **Tech Stack**: [languages, frameworks, Hedera SDK version] - **Hedera Services Used**: [list] ## Scorecard | Section | Score | Weight | Weighted | Key Finding | | ----------- | -------- | ------ | -------- | ------------------ | | Innovation | X/5 | 10% | X.X | [one-line summary] | | Feasibility | X/5 | 10% | X.X | [one-line summary] | | Execution | X/5 | 20% | X.X | [one-line summary] | | Integration | X/5 | 15% | X.X | [one-line summary] | | Validation | X/5 | 15% | X.X | [one-line summary] | | Success | X/5 | 20% | X.X | [one-line summary] | | Pitch | X/5 | 10% | X.X | [one-line summary] | | **Total** | **X/35** | | **X.X** | | **Estimated Final Grade: X%** ## Detailed Findings ### [Section Name] - X/5 **Evidence**: [What was found in the code] **Gaps**: [What's missing] **Quick Wins**: [Specific, actionable improvements] [Repeat for each section] ## Top 5 Improvements (Ranked by Score Impact) 1. [Highest impact improvement] - affects [criteria] ([weight]%) 2. ... 3. ... 4. ... 5. ... ## Hedera Integration Depth Analysis - Services detected: [list with evidence] - Ecosystem integrations: [list or "none detected"] - Creative usage: [describe or "none detected"] - Recommendation: [specific services or integrations to add] ``` ## Step 4: Prioritized Action Items After the scorecard, provide a prioritized list of improvements ordered by impact on the final weighted score. Focus on: 1. **Execution improvements** (20% weight) - code quality, testing, documentation 2. **Success improvements** (20% weight) - network impact, account creation flows 3. **Integration improvements** (15% weight) - add more Hedera services, ecosystem partners 4. **Validation improvements** (15% weight) - add user feedback mechanisms For each improvement, estimate the effort (quick fix, moderate, significant) and the potential score increase. ## Scoring Formula Reference ``` Weighted Score = (Score / 5) * (Section Weighting / 100 * 35) Final Grade = (Sum of Weighted Scores / 35) * 100 ``` ## Important Notes - Be constructive, not discouraging. Frame gaps as opportunities. - Base scores on evidence found in the codebase, not assumptions. - If you can't assess a criterion from the code (e.g., Validation, Pitch), say so explicitly and suggest how the team can document evidence. - Refer to `references/judging-criteria.md` for the complete rubric with detailed 1/3/5 descriptors per criterion.
© hedera-dev · Apache-2.0 · hedera-dev/hedera-skills