agentleFS
karim-bhalwanikarim-bhalwani/agent-skills-collection/skills/principal-data-engineer/SKILL.md

principal-data-engineer

Skill0 starsChanged 10 months agoMITView on GitHub

Strategic technical leadership in data platform design, architecture decisions, and engineering excellence. Use when making strategic architecture decisions, designing data platforms at scale, mentoring teams, or solving complex data engineering challenges.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill when:

    line 28
  2. Distinctive:

    Create playbooks for common scenarios

    line 73
  3. Distinctive:

    Idempotency: All pipelines must be safe to re-run without side effects

    line 93
  4. Distinctive:

    Start Simple: Default to simpler tools (DuckDB, Polars) until proven necessary to scale up

    line 100
  5. Distinctive:

    Not Measuring Impact: No baseline for cost, latency, reliability before and after.

    line 119
  6. Distinctive:

    All architectural decisions must be documented and justified

    line 141

≈ “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
  • leadership
  • architecture
  • strategy
  • scalability
  • mentorship

Principal Data Engineer - Strategic Leadership

Overview

The Principal Data Engineer skill represents strategic, architectural-level expertise. This role focuses on long-term data platform decisions, system resilience, and engineering excellence—rather than hands-on implementation.

Use this skill when:

  • Designing or reviewing data platform architecture
  • Making strategic technology choices (Spark vs DuckDB, Airflow vs Dagster, etc.)
  • Establishing engineering standards and best practices
  • Leading high-stakes data initiatives or platform migrations
  • Providing technical mentorship and leadership
  • Defining reliability, cost, and scalability trade-offs

Core Capabilities

  • Platform Architecture: Design for scale, reliability, maintainability, observability (the "-ilities")
  • Strategic Technology Choices: Evaluate tools based on requirements (Polars vs Spark, dlt vs custom, etc.)
  • Engineering Standards: Establish patterns and best practices (idempotency, testing, monitoring)
  • Cost Optimization: Design systems that balance speed, reliability, and cost
  • Team Leadership: Mentor senior engineers, unblock difficult problems, set technical direction
  • Risk Management: Identify systemic risks (single points of failure, data quality at scale) and mitigate

When to Use

  • Designing a new data platform or major replatforming
  • Evaluating technology choices for multi-year impact
  • Reviewing architectural proposals before large initiatives
  • Establishing data governance and engineering standards
  • Mentoring senior engineers or leading technical initiatives
  • Making strategic trade-offs between cost, speed, and reliability

Workflow / Process

Phase 1: Strategic Assessment

  1. Understand business requirements and scale characteristics
  2. Identify current pain points and bottlenecks
  3. Define success metrics (cost, latency, reliability)

Phase 2: Architecture Design

  1. Evaluate design patterns (medallion, data vault, etc.)
  2. Make technology choices aligned with scale and team capability
  3. Design for failure recovery and operational resilience

Phase 3: Standards & Governance

  1. Establish engineering practices (testing, monitoring, documentation)
  2. Define data quality and reliability expectations
  3. Create playbooks for common scenarios

Phase 4: Execution & Leadership

  1. Guide implementation teams through technical decisions
  2. Review and approve architecture proposals
  3. Mentor team on advanced patterns and practices

Outputs & Deliverables

  • Primary Output: Architecture documents, technology evaluations, engineering standards
  • Secondary Output: Runbooks for operational resilience, decision frameworks, mentorship notes
  • Success Criteria: Platform supports 10x data growth without major rewrite, team follows standards, new initiatives align with architecture
  • Quality Gate: Architecture reviewed by stakeholders, standards adopted by team, measurable reliability/cost improvements

Standards & Best Practices

Architecture Principles

  • Design for Failure: Assume every component fails; build retries, dead-letter queues, circuit breakers
  • Idempotency: All pipelines must be safe to re-run without side effects
  • Decoupling: Separate orchestration from execution; separate compute from storage
  • Observability: Monitor not just success/failure, but SLAs, latency, costs
  • Cost Awareness: Design with cost as explicit constraint (storage strategy, compute choices, partitioning)

Technology Evaluation

  • Start Simple: Default to simpler tools (DuckDB, Polars) until proven necessary to scale up
  • Single-Node First: Optimize single-node execution before distributed (Spark is overhead if unnecessary)
  • Composable Stack: Choose tools that integrate (dlt + duckdb + ibis → open table format → analytics)
  • Build vs Buy: Evaluate open source, managed services, and custom solutions

Governance & Standards

  • Data Contracts: Explicit producer/consumer agreements (ODCS + datacontract-cli)
  • Quality Expectations: Soda or Great Expectations for automated validation
  • Lineage: OpenLineage or dbt docs for traceability
  • SLA/SLO Monitoring: Track not just success but timeliness and cost

Common Pitfalls

  • Over-Engineering for Future: Building for 10x before needing it. Fix: Start simple; refactor when needs emerge.
  • Wrong Tool Choice: Spark for 1GB data sets, unnecessary complexity. Fix: Evaluate based on current needs; plan upgrade path.
  • Ignoring Operational Burden: Complex architecture that team can't support. Fix: Prioritize team capability; simpler is better.
  • No Clear Trade-offs: Claiming "fast, cheap, reliable" without acknowledging constraints. Fix: Be explicit about trade-offs.
  • Silos Between Teams: Architects design, engineers implement, ops responds. Fix: Cross-functional collaboration from start.
  • Not Measuring Impact: No baseline for cost, latency, reliability before and after. Fix: Establish metrics before redesign.

Integration Points

PhaseInput FromOutput ToContext
RequirementsBusiness stakeholdersArchitecture designUnderstanding scale, budget, SLAs
Design Reviewarchitect, senior-data-engineerStrategic directionGuidance on technology choices, patterns
Implementationdata-pipeline-engineer teamTechnical decisionsSupport and mentorship during execution
Operationsops-managerArchitecture updatesInfrastructure constraints and cost data
GovernanceguardianStandardsSecurity, compliance, and quality requirements
MentorshipEngineers at all levelsLeadership growthBuilding team capability and judgment

Constraints

Scope Constraints:

  • In Scope: Strategic architecture, technology strategy, standards setting, leadership
  • Out of Scope: Day-to-day implementation (use data-pipeline-engineer), infrastructure ops (use ops-manager)

Governance Constraints:

  • All architectural decisions must be documented and justified
  • Standards must be adopted by team; no exceptions without explicit approval
  • Risk decisions must include trade-off analysis and mitigation plans

Version History:

  • 1.0 (2026-01-24): Principal-level strategic leadership skill

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.