CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spark-engineer

Use when writing Spark jobs, debugging performance issues, or configuring cluster settings for Apache Spark applications, distributed data processing pipelines, or big data workloads. Invoke to write DataFrame transformations, optimize Spark SQL queries, implement RDD pipelines, tune shuffle operations, configure executor memory, process .parquet files, handle data partitioning, or build structured streaming analytics.

75

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured overview: a validated five-step workflow with a feedback loop, mostly executable PySpark examples, a crisp MUST DO/MUST NOT constraint list, and clean progressive disclosure into five real reference files. Its main weaknesses are the placeholder code in the caching example and trimmable sections (persona intro, Knowledge Reference list) that spend tokens on things Claude already knows.

Suggestions

Drop the 'Knowledge Reference' section and the persona intro line ('Senior Apache Spark engineer specializing in...') — they list concepts Claude already knows and spend context tokens without adding guidance.

Replace the placeholder code in the caching example ('df.filter(...).withColumn(...)') with concrete filter and withColumn calls so the pattern is copy-paste executable like the other examples.

Move the maintainer attribution and documentation link into the YAML frontmatter metadata to keep the body purely instructional.

DimensionReasoningScore

Conciseness

The body is largely lean and instructional, but the 'Knowledge Reference' topic list ('Spark DataFrame API, Spark SQL, RDD transformations/actions, catalyst optimizer, tungsten execution engine...') and the persona intro line restate knowledge Claude already has and could be trimmed; not 3 because there is no significant padded explanation.

4 / 5

Actionability

The quick-start pipeline, broadcast join, and salting examples are concrete and executable, but the caching example uses placeholder pseudocode ('df.filter(...).withColumn(...)') and the join snippets reference undefined variables, leaving minor gaps that keep it below fully copy-paste-ready.

4 / 5

Workflow Clarity

The five-step Core Workflow ends with an explicit validation checkpoint ('Check Spark UI for shuffle spill before proceeding; verify partition count with df.rdd.getNumPartitions()') and an explicit feedback loop ('if spill or skew detected, return to step 4'), matching the anchor for clear sequence with validation and error recovery.

5 / 5

Progressive Disclosure

The Reference Guide table provides well-signaled, one-level-deep references with a 'Load When' column, and all five referenced files (spark-sql-dataframes.md, rdd-operations.md, partitioning-caching.md, performance-tuning.md, streaming-patterns.md) exist in references/, giving clear overview-plus-detail navigation.

5 / 5

Total

18

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it explicitly answers both what the skill does and when to use it, enumerates many concrete actions, and includes natural trigger synonyms and a file extension. Third-person imperative voice is used correctly and no over-claiming is present.

DimensionReasoningScore

Specificity

The description lists eight concrete actions ('write DataFrame transformations, optimize Spark SQL queries, implement RDD pipelines, tune shuffle operations, configure executor memory, process .parquet files, handle data partitioning, or build structured streaming analytics'), providing comprehensive concrete coverage rather than the minor gaps of a 4.

5 / 5

Completeness

Both 'what' ('Invoke to write DataFrame transformations...') and 'when' ('Use when writing Spark jobs, debugging performance issues, or configuring cluster settings...') are explicitly stated with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural trigger terms include synonyms ('Spark jobs', 'Apache Spark applications', 'big data workloads') and a file extension ('.parquet'), matching the anchor-5 pattern of comprehensive coverage; the absence of 'PySpark'/'Scala' is too minor to warrant 4.

5 / 5

Distinctiveness Conflict Risk

The description occupies a clear Apache Spark niche with distinct triggers (DataFrame, RDD, Spark SQL, shuffle, structured streaming, .parquet) and minimal overlap with other skills.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Jeffallan/claude-skills

Path

skills/spark-engineer/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.