cv_improve

Produce evidence-grounded CV improvement recommendations, optional job-specific guidance and ATS actions without inventing candidate facts.

When to use

Use when a candidate or recruitment agent needs actionable CV improvement guidance.

Selection guidance

Role: specialized. Use when a candidate or recruitment agent needs actionable CV improvement guidance.

Use cases

• CV improvement
• resume rewrite guidance
• ATS optimization

Access

• REST: POST https://api.rafidsystem.com/api/v1/recruitment/cv-improve
• x402: POST https://api.rafidsystem.com/api/v1/x402/recruitment/cv-improve
• MCP tool: cv_improve

Price: $0.25 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.

Related tools

• cv_job_match
• extract_candidate_profile
• generate_job_profile
• candidate_shortlist_score

Example input

{
  "cv_text": "Software Engineer\nExperience\nDeveloper 2022-2024\nSkills\nJavaScript",
  "mode": "recommendations"
}

Example output

{
  "current_score": 65,
  "priority_actions": [
    "Use evidence-backed achievement bullets.",
    "Keep dates and role titles consistent."
  ],
  "summary_recommendations": [
    "Lead with a concise role-relevant summary backed by evidence."
  ],
  "experience_recommendations": [
    "Rewrite bullets as action, context, result; add numbers only when known."
  ],
  "skill_recommendations": [
    "Group skills by category and use canonical names."
  ],
  "ats_recommendations": [
    "Use standard section headings and consistent dates."
  ],
  "job_specific_recommendations": [],
  "rewrite_examples": [],
  "keywords_to_consider": [],
  "warnings": [
    "Recommendations never invent experience, achievements, technologies, certifications or metrics."
  ]
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cv_text": {
      "type": "string",
      "maxLength": 200000
    },
    "target_job_description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 100000
        },
        {
          "type": "null"
        }
      ]
    },
    "candidate_profile": {},
    "mode": {
      "default": "recommendations",
      "type": "string",
      "enum": [
        "recommendations",
        "rewrite_summary",
        "rewrite_experience",
        "ats_optimization",
        "full_improvement_plan"
      ]
    }
  },
  "required": [
    "mode"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "current_score": {
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "priority_actions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "summary_recommendations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "experience_recommendations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "skill_recommendations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "ats_recommendations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "job_specific_recommendations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "rewrite_examples": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "keywords_to_consider": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "current_score",
    "priority_actions",
    "summary_recommendations",
    "experience_recommendations",
    "skill_recommendations",
    "ats_recommendations",
    "job_specific_recommendations",
    "rewrite_examples",
    "keywords_to_consider",
    "warnings"
  ],
  "additionalProperties": false
}

Category: Recruitment Intelligence · hierarchy: specialized · idempotent: yes · side effects: no