agentleFS
G1JoshiG1Joshi/Agent-Skills/skills/languages/scala/SKILL.md

scala

Skill15 starsChanged 43 days agoMITView on GitHub

Expert Scala (Scala 3) assistance covering functional programming, Akka/Pekko, ZIO, Cats Effect, and Spark. Use when developing distributed systems, high-concurrency microservices, or big data pipelines.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 0 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use Scala 3 concise enum definitions:

    line 109
  2. Very specific:

    Use opaque type aliases for type-safe domain identifiers (e.g.

    line 128
  3. Very specific:

    Use var or mutable collections in domain logic.

    line 134
  4. Very specific:

    Use Option.get or Try.get.

    line 136

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Scala

Scalable Language. It interops seamlessly with Java.

When to Use

  • Big Data Distributed Processing: Apache Spark, Apache Flink, and large-scale data engineering pipelines.
  • High-Concurrency Reactive Systems: Building resilient distributed services with Akka/Pekko actors or Cats Effect/ZIO.
  • Type-Level & Purely Functional Programming: Enforcing compile-time domain guarantees with Scala 3 given/using and opaque types.
  • Enterprise JVM Microservices: Leveraging the entire Java ecosystem while utilizing concise, expressive FP idioms.

Quick Start

object Hello extends App {
  println("Hello, World!")

  val list = List(1, 2, 3)
  val doubled = list.map(_ * 2)
  println(doubled)
}

Core Concepts

Scala 3 Contextual Abstractions: Given & Using

Type classes and dependency injection unified cleanly without implicit conversions:

// Define type class
trait JsonEncoder[A]:
  def encode(a: A): String

// Given instances (type class implementations)
given JsonEncoder[String] with
  def encode(a: String): String = s"\"${a.replace(""", "\\"")}\""

given JsonEncoder[Int] with
  def encode(a: Int): String = a.toString

// Contextual function with 'using' clause
def toJson[T](value: T)(using encoder: JsonEncoder[T]): String =
  encoder.encode(value)

// Extension methods for clean syntax
extension [T](value: T)(using encoder: JsonEncoder[T])
  def asJson: String = encoder.encode(value)

Algebraic Data Types & Exhaustive Pattern Matching

Modeling domain states with Scala 3 sealed traits and enums:

enum PaymentStatus:
  case Pending
  case Authorized(transactionId: String, amountCents: Long)
  case Failed(reason: String, retryable: Boolean)

def evaluatePayment(status: PaymentStatus): String = status match
  case PaymentStatus.Pending =>
    "Waiting for gateway response..."
  case PaymentStatus.Authorized(txId, amt) =>
    s"Payment $txId confirmed for \$${amt / 100.0}"
  case PaymentStatus.Failed(reason, true) =>
    s"Transient error: $reason. Retrying..."
  case PaymentStatus.Failed(reason, false) =>
    s"Permanent failure: $reason. Contacting customer."

Asynchronous Effect Management with Cats Effect

Pure functional concurrency with resource safety and fiber cancellation:

import cats.effect.{IO, IOApp, Resource}
import scala.concurrent.duration.*

object ServerApp extends IOApp.Simple:
  def acquireDbConnection: IO[String] = IO.println("DB Connected") *> IO.pure("conn-123")
  def releaseDbConnection(conn: String): IO[Unit] = IO.println(s"DB Disconnected: $conn")

  val dbResource: Resource[IO, String] =
    Resource.make(acquireDbConnection)(releaseDbConnection)

  def run: IO[Unit] =
    dbResource.use { conn =>
      for
        fiber <- IO.sleep(100.millis).as("Query result").start
        res   <- fiber.joinWithNever
        _     <- IO.println(s"Executed on $conn: $res")
      yield ()
    }

Common Patterns

Enum and Pattern Matching in Scala 3

Problem: Verbose sealed trait hierarchies for algebraic data types in legacy Scala 2.

Solution: Use Scala 3 concise enum definitions:

enum TransactionStatus:
  case Pending
  case Approved(txId: String, amount: BigDecimal)
  case Rejected(reason: String)

def describe(status: TransactionStatus): String = status match
  case TransactionStatus.Pending => "Transaction is being processed"
  case TransactionStatus.Approved(id, amount) => s"Approved $id: $$$amount"
  case TransactionStatus.Rejected(reason) => s"Declined: $reason"

Best Practices

Do:

  • Embrace Scala 3 syntax: use enum, given/using, and top-level definitions instead of Scala 2 package objects.
  • Use opaque type aliases for type-safe domain identifiers (e.g. UserId, OrderId) without heap allocation overhead.
  • Structure async applications around functional effect systems (Cats Effect 3 or ZIO 2) rather than raw scala.concurrent.Future.
  • Enable compiler strictness (-Xfatal-warnings, -Wunused:all) to maintain clean codebases.

Don't:

  • Use var or mutable collections in domain logic; use immutable collections and case class .copy().
  • Catch raw Throwable without re-throwing non-fatal exceptions; use scala.util.control.NonFatal.
  • Use Option.get or Try.get; use getOrElse, pattern matching, or for-comprehensions.

Troubleshooting

ErrorCauseSolution
type mismatch: found ... required ...Incompatible types in expression or missing implicit conversion.Verify types and import appropriate typeclass instances.
No implicit arguments found of type ...Missing using / implicit parameter in scope (e.g. ExecutionContext).Import default execution context: import scala.concurrent.ExecutionContext.Implicits.global.
OutOfMemoryError during sbt compileJVM heap limit too low for Scala compiler.Increase heap in .sbtopts: -J-Xmx4G.

References

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.