/ Directory / Playground / skill-arkts-syntax-assistant
● Community SummerKaze ⚡ Instant

skill-arkts-syntax-assistant

by SummerKaze · SummerKaze/skill-arkts-syntax-assistant

Claude Code skill for ArkTS — OpenHarmony's stricter TypeScript. Covers syntax, TS→ArkTS migration, perf patterns, and compilation errors.

ArkTS is the default language for OpenHarmony apps: TypeScript with stricter static typing and a ban on dynamic object mutation. skill-arkts-syntax-assistant teaches Claude the constraints: declarations/types/functions/classes/modules, TypeScript→ArkTS migration gotchas, performance best practices (memory, loops, arrays, exceptions), and compilation error diagnosis. Auto-activates on ArkTS-related questions.

Why use it

Key features

Live Demo

What it looks like in practice

skill-arkts-syntax-assistant-skill.replay ▶ ready
0/0

Install

Author repository · Claude Skills documentation

Use Cases

Real-world ways to use skill-arkts-syntax-assistant

Migrate a TypeScript module to ArkTS without fighting the compiler

👤 Devs porting existing TS code to OpenHarmony ⏱ ~45 min intermediate

When to use: You pasted TS into an ArkTS file and the compiler erupted.

Flow
  1. Paste the errors
    Use skill-arkts-syntax-assistant — here's the TS file and the ArkTS compile errors. What's incompatible?✓ Copied
    → Errors explained with ArkTS's stricter rules, not generic TS advice
  2. Get a compliant rewrite
    Rewrite the file to be ArkTS-valid while preserving behavior.✓ Copied
    → Rewrite with typed declarations and no dynamic object mutations

Outcome: A clean ArkTS port with a note on why each change was needed.

Pitfalls
  • Dynamic property access patterns are everywhere in the original — Skill will refactor to typed interfaces — accept the added verbosity
Combine with: filesystem

Diagnose a specific ArkTS compilation error

👤 HarmonyOS devs stuck on a specific error ⏱ ~10 min beginner

When to use: Compiler message is cryptic and the docs don't explain.

Flow
  1. Share error + code
    skill-arkts-syntax-assistant — error: <paste>. Code: <paste>.✓ Copied
    → Root cause explained in ArkTS terms + correct pattern

Outcome: A fix plus understanding of why the rule exists.

Review a hot loop for ArkTS-specific performance issues

👤 HarmonyOS app developers tuning performance ⏱ ~20 min intermediate

When to use: Component is janky; you suspect allocation or typing pitfalls.

Flow
  1. Show the code
    skill-arkts-syntax-assistant — perf review this loop. Memory and allocation patterns.✓ Copied
    → Specific allocations flagged + array/object alternatives

Outcome: A measurably faster version or a clear 'this is already fine' verdict.

Combinations

Pair with other MCPs for X10 leverage

skill-arkts-syntax-assistant-skill + filesystem

Batch-migrate a whole directory of TS files to ArkTS

For every .ts file under src/utils, apply the ArkTS migration and save as .ets.✓ Copied
skill-arkts-syntax-assistant-skill + github

Open a PR with migration diffs chunked by file

After migration, open a PR with one commit per migrated file.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
migrate_ts_file TS file path + compile errors Porting TS code 0
diagnose_error error text + code snippet Stuck on a specific compiler error 0
perf_review code + suspect area Tuning HarmonyOS component perf 0

Cost & Limits

What this costs to run

API quota
None
Tokens per call
Moderate — pattern examples loaded when needed
Monetary
Free — skills are local files
Tip
Migrate file-by-file rather than whole-repo to keep context manageable.

Security

Permissions, secrets, blast radius

Credential storage: No credentials — pure prompts
Data egress: None

Troubleshooting

Common errors and fixes

Wrong trigger keywords — compile error not resolved

Include the exact compiler message in the prompt, not a paraphrase.

Alternatives

skill-arkts-syntax-assistant vs others

AlternativeWhen to use it insteadTradeoff
Vanilla TypeScript skillsYou're not targeting HarmonyOSMisses ArkTS's stricter rules
OpenHarmony official docsYou want authoritative reference material, not a chat interfaceNo interactive diagnosis

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills

Continue exploring

Related tools and workflows

Choose another guide for your workflow, or explore a collection.

Shared context · learning

Snowflake AI Kit

Connect your coding agent to Snowflake’s Cortex Code workflows for SQL, data governance, dynamic tables, machine learning, and warehouse operations.

Skill

Shared context · learning

Honeycomb MCP Skills Pack

Follow Honeycomb’s guided investigation, telemetry exploration, and SLO learning workflows from an AI coding assistant.

Skill

Browse all topic collections → · See 29 new official additions →