Back to Skills

solve-modular-arithmetic

pjt222
Updated 2 days ago
7 views
17
2
17
View on GitHub
Otherai

About

This skill solves modular arithmetic problems including linear congruences, modular inverses, and systems of equations using the Chinese Remainder Theorem. It applies number theory concepts like Euler's theorem for large exponentiations and works in discrete logarithm contexts. Use it for both manual step-by-step solutions and computational approaches in number theory and cryptography.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/solve-modular-arithmetic

Copy and paste this command in Claude Code to install this skill

Documentation

Solve Modular Arithmetic

Solve modular arithmetic problems. Parse congruence systems. Apply extended Euclidean algorithm for inverses. Use Chinese Remainder Theorem for simultaneous congruences. Leverage Euler's theorem for modular exponentiation. Verify every solution by substitution.

When Use

  • Solve single linear congruence ax = b (mod m)
  • Solve system of simultaneous congruences (Chinese Remainder Theorem)
  • Compute modular inverse a^{-1} (mod m)
  • Evaluate large modular exponentiations a^k (mod m)
  • Determine order of element in Z/mZ
  • Work with cyclic groups, primitive roots, or discrete logarithm contexts

Inputs

  • Required: Congruence(s) or modular equation to solve
  • Optional: Whether to show extended Euclidean algorithm steps explicit
  • Optional: Whether Euler's theorem or Fermat's little theorem should be applied
  • Optional: Whether to find primitive roots or element orders
  • Optional: Output format (step-by-step, compact, or proof-style)

Steps

Step 1: Parse Congruence System or Modular Equation

Extract mathematical structure from problem statement.

  1. Identify the type:

    • Single linear congruence: ax = b (mod m)
    • System of congruences: x = a1 (mod m1), x = a2 (mod m2), ...
    • Modular exponentiation: a^k (mod m)
    • Modular inverse: find a^{-1} (mod m)
  2. Normalize: Reduce all coefficients modulo their respective moduli. Ensure a, b, m are non-negative integers with m > 0.

  3. Record the parsed problem in standard notation.

Got: Clear parsed and normalized modular problem with all values reduced.

If fail: Notation ambiguous (e.g., "solve 3x + 5 = 2 mod 7" could mean 3x + 5 = 2 (mod 7) or 3x + (5 = 2 mod 7))? Clarify with user. Default to interpreting mod as applying to entire equation.

Step 2: Solve Single Congruence (if applicable)

Solve ax = b (mod m) using extended Euclidean algorithm.

  1. Compute g = gcd(a, m) using the Euclidean algorithm:

    • Apply repeated division: m = q1a + r1, a = q2r1 + r2, ... until remainder = 0.
    • The last non-zero remainder is gcd(a, m).
  2. Check solvability: ax = b (mod m) has a solution if and only if g | b.

    • If g does not divide b, the congruence has no solution. Stop.
  3. Reduce: Divide through by g to get (a/g)x = (b/g) (mod m/g). Now gcd(a/g, m/g) = 1.

  4. Find the modular inverse of a/g modulo m/g using the extended Euclidean algorithm:

    • Back-substitute through the Euclidean algorithm steps to express gcd as a linear combination: 1 = (a/g)*s + (m/g)*t.
    • The coefficient s (reduced mod m/g) is the inverse.
  5. Compute the particular solution: x0 = s * (b/g) mod (m/g).

  6. Write the general solution: x = x0 + (m/g)*k for k = 0, 1, ..., g - 1 gives all g incongruent solutions modulo m.

Extended Euclidean algorithm example (finding 17^{-1} mod 43):

43 = 2*17 + 9
17 = 1*9  + 8
 9 = 1*8  + 1
 8 = 8*1  + 0

Back-substitute:
1 = 9 - 1*8
  = 9 - 1*(17 - 1*9) = 2*9 - 17
  = 2*(43 - 2*17) - 17 = 2*43 - 5*17

So 17*(-5) = 1 (mod 43), i.e., 17^{-1} = -5 = 38 (mod 43).

Got: Complete solution set for congruence, or proof no solution exists.

If fail: Extended Euclidean back-substitution produces wrong result? Verify each division step. Most common error: sign mistake during back-substitution. Check: a * inverse mod m should equal 1.

Step 3: Solve System via Chinese Remainder Theorem (if applicable)

Solve x = a1 (mod m1), x = a2 (mod m2), ..., x = ak (mod mk).

  1. Check pairwise coprimality: For every pair (mi, mj), verify gcd(mi, mj) = 1.

    • If all pairs are coprime, CRT applies directly.
    • If some pairs are not coprime, check compatibility: for each non-coprime pair, verify ai = aj (mod gcd(mi, mj)). If compatible, reduce using lcm. If incompatible, no solution exists.
  2. Compute M = m1 * m2 * ... * mk (the product of all moduli).

  3. For each i, compute Mi = M / mi (the product of all moduli except mi).

  4. For each i, find yi = Mi^{-1} (mod mi) using the extended Euclidean algorithm from Step 2.

  5. Compute the solution: x = sum(ai * Mi * yi for i = 1..k) mod M.

  6. State the result: x = [value] (mod M). This is the unique solution modulo M.

Common totients reference:

nphi(n)nphi(n)nphi(n)
21104208
321110248
421242520
541312308
621463612
761584816
841686016
9618610040

Got: Unique solution modulo M, or proof of incompatibility.

If fail: CRT computation yields result that fails verification? Check modular inverse computations in step 4. Common mistake: computing Mi^{-1} mod M instead of Mi^{-1} mod mi. Each inverse is computed modulo individual modulus, not the product.

Step 4: Apply Euler's Theorem or Fermat's Little Theorem (if applicable)

Evaluate modular exponentiations or simplify expressions using Euler's theorem.

  1. Euler's theorem: If gcd(a, m) = 1, then a^{phi(m)} = 1 (mod m).

    • Compute phi(m) using the totient formula: if m = p1^e1 * p2^e2 * ... * pk^ek, then phi(m) = m * product((1 - 1/pi) for each prime pi dividing m).
  2. Fermat's little theorem (special case): If p is prime and gcd(a, p) = 1, then a^{p-1} = 1 (mod p).

  3. Reduce the exponent: To compute a^k (mod m):

    • Compute r = k mod phi(m).
    • Then a^k = a^r (mod m).
  4. Compute a^r (mod m) using repeated squaring (binary exponentiation):

    • Write r in binary: r = b_n * 2^n + ... + b_1 * 2 + b_0.
    • Start with result = 1.
    • For each bit from most significant to least: result = result^2 mod m; if bit is 1, result = result * a mod m.
  5. Handle the case gcd(a, m) > 1: Euler's theorem does not apply directly. Factor m and use CRT to combine results from prime power moduli, using lifting the exponent or direct computation.

Got: Value of a^k (mod m), computed via exponent reduction and repeated squaring.

If fail: gcd(a, m) > 1 and result seems wrong? Never apply Euler's theorem. Instead, compute direct or factor m into coprime parts where at least some parts are coprime to a, solve modulo each part, recombine with CRT.

Step 5: Verify Solution by Substitution

Check every solution by plugging back into original equations.

  1. For single congruences: Compute a * x mod m and verify it equals b.

  2. For CRT systems: For each congruence x = ai (mod mi), verify x mod mi = ai.

  3. For modular exponentiations: If possible, verify with a second computational method (e.g., direct computation for small values, or independent repeated squaring implementation).

  4. Document the verification explicitly:

Solution: x = 23
Check 1: 23 mod 3 = 2 = a1. Correct.
Check 2: 23 mod 5 = 3 = a2. Correct.
Check 3: 23 mod 7 = 2 = a3. Correct.
All congruences satisfied.

Got: All original equations verified with explicit computation shown.

If fail: Verification fails? Trace back through procedure to find computational error. Common sources: arithmetic mistakes in extended Euclidean algorithm, wrong sign in back-substitution, or forgetting reduce modulo M in final CRT step.

Checks

  • Problem type correct identified (single congruence, system, exponentiation, inverse)
  • All coefficients reduced modulo their respective moduli
  • For ax = b (mod m): gcd(a, m) | b checked before solving
  • Extended Euclidean algorithm back-substitution verified: a * inverse mod m = 1
  • For CRT: pairwise coprimality verified before applying theorem
  • For CRT with non-coprime moduli: compatibility checked
  • Euler's theorem applied only when gcd(a, m) = 1
  • Totient phi(m) computed from prime factorization, not guessed
  • Repeated squaring uses modular reduction at every step (no overflow)
  • Every solution verified by substitution into original equations

Pitfalls

  • Apply CRT without coprimality check: Standard CRT formula needs pairwise coprime moduli. Apply to non-coprime moduli? Wrong answer, not error. Always check gcd(mi, mj) = 1 first.

  • Compute wrong inverse: Mi^{-1} must be computed modulo mi (the individual modulus), not modulo M (the product). Single most common CRT implementation error.

  • Apply Euler's theorem when gcd(a, m) > 1: a^{phi(m)} = 1 (mod m) needs gcd(a, m) = 1. Fails? Theorem does not apply, result wrong.

  • Sign errors in extended Euclidean back-substitution: Keep careful track of signs at each step. Final inverse may be negative; always reduce modulo m to get positive representative.

  • Overflow in modular exponentiation: Even with repeated squaring, intermediate products can overflow. Always reduce modulo m after every multiplication, not just at end.

  • Forget multiple solutions: ax = b (mod m) with g = gcd(a, m) > 1 and g | b has exactly g incongruent solutions modulo m, not just one.

See Also

  • analyze-prime-numbers -- Prime factorization needed to compute phi(m) and to verify coprimality
  • explore-diophantine-equations -- Linear Diophantine equations ax + by = c equivalent to linear congruences ax = c (mod b)
  • prove-geometric-theorem -- Modular arithmetic appears in constructibility proofs (e.g., which regular n-gons are constructible)

GitHub Repository

pjt222/agent-almanac
Path: i18n/caveman/skills/solve-modular-arithmetic
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

llamaguard

Other

LlamaGuard is Meta's 7-8B parameter model for moderating LLM inputs and outputs across six safety categories like violence and hate speech. It offers 94-95% accuracy and can be deployed using vLLM, Hugging Face, or Amazon SageMaker. Use this skill to easily integrate content filtering and safety guardrails into your AI applications.

View skill

cost-optimization

Other

This Claude Skill helps developers optimize cloud costs through resource rightsizing, tagging strategies, and spending analysis. It provides a framework for reducing cloud expenses and implementing cost governance across AWS, Azure, and GCP. Use it when you need to analyze infrastructure costs, right-size resources, or meet budget constraints.

View skill

quantizing-models-bitsandbytes

Other

This skill quantizes LLMs to 8-bit or 4-bit precision using bitsandbytes, achieving 50-75% memory reduction with minimal accuracy loss. It's ideal for running larger models on limited GPU memory or accelerating inference, supporting formats like INT8, NF4, and FP4. The skill integrates with HuggingFace Transformers and enables QLoRA training and 8-bit optimizers.

View skill

dispatching-parallel-agents

Other

This Claude Skill dispatches multiple agents to investigate and fix 3+ independent problems concurrently. It is designed for scenarios involving unrelated failures that can be resolved without shared state or dependencies. The core capability is parallel problem-solving, assigning one agent per independent problem domain to maximize efficiency.

View skill