agentleFS
krmisystemskrmisystems/fantasy-football-manager/skills/season-manager/SKILL.md

season-manager

Skill91 starsChanged 2 months agoMITView on GitHub

Manage ESPN season lineups, acquisitions, waiver claims, and IR through authenticated HTTP. Preserve user limits and reconcile every transaction.

The file

Show its rules and text

We split this skill into the rules it gives an agent

39 rules. About 0 are common, 13 are distinctive, and 26 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈13

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 26

    Very specific

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

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

    Read get_capabilities and get_manager_config before selecting a season workflow.

    line 9
  2. Very specific:

    Read espn_get_status and discover the installed companion tools.

    line 10
  3. Distinctive:

    Use the installed version's capabilities.

    line 13
  4. Very specific:

    Read get_team when a snapshot is loaded.

    line 20
  5. Very specific:

    Use load_demo(mode="season") for a requested synthetic demonstration.

    line 22
  6. Very specific:

    Use import_league_snapshot for supplied weekly observations.

    line 23
  7. Very specific:

    Call recommend_lineup for a legal weekly comparison.

    line 24
  8. Very specific:

    Call rank_waiver_candidates to compare additions and required drops.

    line 25
  9. Very specific:

    Use get_power_rankings as a projection-based comparison.

    line 26
  10. Very specific:

    Read get_source_status after an import.

    line 28
  11. Distinctive:

    Do not divide season totals into invented weekly projections.

    line 30
  12. Distinctive:

    Use a separate data directory for demonstrations when real league state is loaded.

    line 33
  13. Very specific:

    Use update_manager_config with the current revision for an authorized configuration change.

    line 38
  14. Very specific:

    Use prepare_action for supported synthetic lineup, acquisition, waiver, or drop proposals.

    line 41
  15. Very specific:

    Use execute_demo_action only within current authorization and required confirmation.

    line 46
  16. Very specific:

    Read the resulting state and get_action_history after execution.

    line 47
  17. Distinctive:

    Do not describe a synthetic result as a change to the real league.

    line 50
  18. Distinctive:

    Verify that the HTTP companion and protected session file are configured.

    line 54
  19. Very specific:

    Call espn_connect with the selected context, phase="season", transport="http", and the requested week.

    line 55
  20. Very specific:

    Call espn_sync and verify source completeness, current week, and own-team locks.

    line 56
  21. Distinctive:

    Verify authenticated ownership and pending transaction evidence.

    line 57
  22. Very specific:

    Call espn_start_automation for continuous operation when requested.

    line 59
  23. Very specific:

    Never request or return credential values through prompts or tool arguments.

    line 64
  24. Distinctive:

    If authentication fails, report the failed prerequisite.

    line 67
  25. Distinctive:

    Use the same state directory for both MCP servers that manage one context.

    line 69
  26. Distinctive:

    Use one credential directory for controllers that share the same account.

    line 70
  27. Very specific:

    Use espn_prepare_season_action with one of these actions:

    line 76
  28. Distinctive:

    Use a whole-number FAAB bid within league and saved user limits.

    line 83
  29. Very specific:

    Use espn_submit_season_action for that proposal.

    line 88
  30. Very specific:

    Do not request per-action confirmation for actions already authorized in automatic mode.

    line 90
  31. Very specific:

    Use espn_reconcile_season_action for another observation of an uncertain result.

    line 91
  32. Distinctive:

    Do not expand repair lists without user authorization.

    line 107
  33. Distinctive:

    Do not drop a player without authorization to create that vacancy.

    line 112
  34. Very specific:

    Read espn_get_status and get_action_history after submission.

    line 122
  35. Very specific:

    Use espn_start_standalone_worker for operation after the MCP client closes, when requested.

    line 127
  36. Very specific:

    Use espn_stop_automation for a shared pause.

    line 128
  37. Very specific:

    Use explicit transport="browser" only for an authorized browser workflow.

    line 133
  38. Very specific:

    Use espn_prepare_lineup, espn_submit_lineup, and espn_reconcile_lineup for one legal swap per proposal.

    line 135
  39. Distinctive:

    Do not report a full optimized lineup as applied after one swap.

    line 137

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 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

Season manager

Read get_capabilities and get_manager_config before selecting a season workflow. Read espn_get_status and discover the installed companion tools. The published v0.4.0 preview supplies 16 ESPN tools and HTTP season operation. Version 0.3.3 has 13 ESPN tools and browser lineup swaps. Use the installed version's capabilities. Do not infer a live write from source code or fictional tests. The manager provides weekly analysis and synthetic execution. The ESPN companion owns real submissions. Trade execution remains unavailable. For live ESPN drafts, use the included espn-automation skill and companion tools.

Review the week

  1. Read get_team when a snapshot is loaded.
  2. Identify the league, team, season, and week.
  3. Use load_demo(mode="season") for a requested synthetic demonstration.
  4. Use import_league_snapshot for supplied weekly observations.
  5. Call recommend_lineup for a legal weekly comparison.
  6. Call rank_waiver_candidates to compare additions and required drops.
  7. Use get_power_rankings as a projection-based comparison.

Read get_source_status after an import. Report missing projections, eligibility, locks, ownership, and pending claims. Do not divide season totals into invented weekly projections. Floor and upside comparisons require supplied bounds. Projection rankings do not establish matchup or championship probabilities. Use a separate data directory for demonstrations when real league state is loaded.

Policy and proposals

Preserve the user's authorized action modes and hard limits. Use update_manager_config with the current revision for an authorized configuration change. Strategy changes do not grant action permission.

Use prepare_action for supported synthetic lineup, acquisition, waiver, or drop proposals. Review the complete add/drop transaction and its budget effects. An empty drop list permits no drops in listed_only mode. Protected players and pending commitments remain hard checks.

Use execute_demo_action only within current authorization and required confirmation. Read the resulting state and get_action_history after execution. For a supported live season action, use the HTTP companion workflow below. For a trade request, report the unavailable execution adapter and provide only supported analysis. Do not describe a synthetic result as a change to the real league.

HTTP season connection

  1. Verify that the HTTP companion and protected session file are configured.
  2. Call espn_connect with the selected context, phase="season", transport="http", and the requested week.
  3. Call espn_sync and verify source completeness, current week, and own-team locks.
  4. Verify authenticated ownership and pending transaction evidence.
  5. Preserve the user's authorized action modes, strategy, and limits.
  6. Call espn_start_automation for continuous operation when requested.

HTTP season operation does not start or control a browser. It requires neither Chrome nor Playwright. The protected file contains only SWID and espn_s2. Configure its path through FFM_ESPN_CREDENTIAL_FILE or the server --credential-file option. Never request or return credential values through prompts or tool arguments. The optional Linux v10 importer reads an existing authorized session without starting Chromium. It does not renew an expired session or support all operating-system encryption formats. If authentication fails, report the failed prerequisite. Do not silently switch to browser control.

Use the same state directory for both MCP servers that manage one context. Use one credential directory for controllers that share the same account. The HTTP team lease blocks simultaneous control of the same league and team through that directory. Different teams can hold separate leases. A connection close releases its lease.

Exact season transactions

Use espn_prepare_season_action with one of these actions:

  • set_lineup: provide the complete starter map, including unchanged starters.
  • free_agent_add or waiver_claim: provide player_id, an optional drop_id, and bid.
  • drop_player, move_to_ir, or activate_from_ir: provide player_id only.

Traditional waivers and free-agent additions require a zero bid. Use a whole-number FAAB bid within league and saved user limits. A required drop must have separate permission. Protected players and pending commitments remain hard checks. Unknown counters or incomplete budget evidence cannot establish unused capacity.

Review the returned action, exact payload, mode, revisions, and confirmation requirement. Use espn_submit_season_action for that proposal. Set confirmation=true only after required approval of the exact review-mode proposal. Do not request per-action confirmation for actions already authorized in automatic mode. Use espn_reconcile_season_action for another observation of an uncertain result.

An HTTP lineup proposal can contain several legal positional changes. An acquisition and a later starter assignment require separate confirmed transactions. The automatic loop evaluates one admitted transaction per cycle before observing again. Automatic FAAB claims use the league minimum. A different bid requires an exact proposal.

Coverage and IR

Missing projections remain unknown. Never substitute zero or divide season totals into a weekly estimate. Ordinary changes require a known improvement that meets the saved limit. A coverage exception requires the current starter in limits.coverage_repair_ids. A nonempty limits.coverage_repair_add_ids restricts replacement candidates to that list. For a manual repair proposal, pass the named starter through repair_player_id. The repair must replace that starter's verified coverage gap only. Preserve eligibility, locks, available projections for the replacement, drop permission, and budgets. Do not expand repair lists without user authorization.

An IR move requires ESPN's explicit injured=true, IR slot eligibility, clear locks, and available IR capacity. An injury label or eligibleSlots membership alone is insufficient. Activation requires bench eligibility and an active roster vacancy. Do not drop a player without authorization to create that vacancy.

Results, rollover, and lifetime

confirmed requires the observed result. An acquisition requires observed ownership. pending_waiver means a queued claim. Do not start that player or report ownership before later confirmation. not_submitted proves that preflight ended before the transaction request began. Correct that cause before preparing a new authorized proposal. awaiting_verification requires more observation. Never retry it as a new proposal. rejected, cancelled, and conflict require inspection of the saved receipt and actual state. Read espn_get_status and get_action_history after submission.

Set auto_rollover=true only when the user authorizes continued operation across scoring periods. The service follows ESPN's verified current period. Backward or unknown periods stop rollover. Unresolved submissions and pending waivers retain their original week. Use espn_start_standalone_worker for operation after the MCP client closes, when requested. Use espn_stop_automation for a shared pause. Disconnecting one process does not pause another worker. A bounded in-flight operation can finish after a pause request.

Legacy browser lineup operation

Use explicit transport="browser" only for an authorized browser workflow. This adapter requires the browser extra and Chrome. Use espn_prepare_lineup, espn_submit_lineup, and espn_reconcile_lineup for one legal swap per proposal. Each intermediate swap must meet the improvement limit. Do not report a full optimized lineup as applied after one swap. Reconnect explicitly for another week. This adapter does not execute HTTP acquisitions, IR moves, or automatic rollover.

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.