# AI Skills Catalog (v1.7) schema_version: "1.2" # Catalog structure version skills: # --- Text Analysis & Generation Skills --- - skill_id: "SummarizeText" description: "Generates a summary of a given text based on specified parameters. Applies internal Meta-RefineOutput principles and AIOperationalProtocols for quality." input_parameters_schema: source_text_content: "string (optional) # The full text. One of source_text_content or source_text_reference must be provided." source_text_reference: "string (optional) # Ref to project_state path or project file (base filename)." summary_type: "string (optional) # Enum: 'Abstractive', 'Extractive', 'Hybrid'. Default: 'Abstractive'." length_constraint: "string (optional) # E.g., '250 words', '3 paragraphs'. Default: 'auto'." focus_area: "string (optional)" target_audience: "string (optional)" output_format: "string (optional) # Enum: 'text', 'markdown'. Default: 'markdown'." output_data_schema: type: "summary_data_inline" summary_data: # Conforms to ProjectStateSchema Section 2.44 (summary_data_object in v5.2) source_reference: "string" summary_type: "string" length_constraint: "string" focus: "string (optional)" audience: "string (optional)" summary_text: "string" - skill_id: "ExtractResearchQuestions" description: "Extracts research questions from text. Applies Meta-RefineOutput and AIOperationalProtocols." input_parameters_schema: source_text_content: "string (optional) # One of source_text_content or source_text_reference must be provided." source_text_reference: "string (optional)" extraction_depth: "string (optional) # Enum: 'Surface', 'Deep_Inferential'. Default: 'Surface'." max_questions: "integer (optional) # Default: no limit." output_data_schema: type: "extracted_questions_list" format: "yaml_block" content_inline: "string # YAML block of a list of extracted_question_item_objects (ProjectStateSchema 2.26 structure in v5.2)" - skill_id: "AnalyzeTextLogic" description: "Performs logical analysis of arguments. Applies Meta-RefineOutput and AIOperationalProtocols." input_parameters_schema: source_text_content: "string (optional) # One of source_text_content or source_text_reference must be provided." source_text_reference: "string (optional)" analysis_framework: "string (optional) # E.g., 'Toulmin'. Default: 'General Critical Reasoning'." output_data_schema: type: "analysis_result_reference" analysis_result_ref: "string # Path to created logic_analysis_report_object in project_state.analysis_results.logic_analyses[ID]" - skill_id: "CritiqueArtifact" description: "Provides a critical review. Applies Meta-RefineOutput and AIOperationalProtocols." input_parameters_schema: artifact_content: "string (optional) # One of artifact_content or artifact_reference must be provided." artifact_reference: "string (optional)" critique_focus_areas: "list of strings (optional)" critique_criteria_reference: "string (optional) # Ref to SuccessMetrics KA (base ID) or other criteria." output_detail_level: "string (optional) # Enum: 'Summary', 'Detailed'. Default: 'Detailed'." output_data_schema: type: "analysis_result_reference" analysis_result_ref: "string # Path to created critique_object in project_state.analysis_results.critiques[ID]" - skill_id: "ConductLiteratureSearch" description: "Performs literature search, returns bibliography/abstracts. Adheres to AIOperationalProtocols." input_parameters_schema: topic: "string" keywords: "list of strings" source_databases: "list of strings (optional) # Default: AI selects." max_results: "integer (optional) # Default: 20." user_provided_date_constraints: "string (optional) # E.g., 'last 5 years'. AI uses this to filter if possible." search_for_publication_year_in_text: "boolean (optional, default: true)" output_data_schema: type: "literature_search_results" format: "yaml_block" content_inline: "string # YAML block: {search_summary: {...}, articles: [{...publication_year_extracted (optional)...}]}" - skill_id: "ConductFullLiteratureReview" description: "Conducts comprehensive literature review. Applies Meta-RefineOutput and AIOperationalProtocols to report." input_parameters_schema: topic: "string" scope_description: "string" initial_keywords: "list of strings (optional)" source_databases: "list of strings (optional)" key_questions_to_answer: "list of strings (optional)" report_structure_outline: "list of strings (optional)" user_provided_date_constraints: "string (optional)" output_data_schema: type: "analysis_result_reference" analysis_result_ref: "string # Path to created literature_review_report_object in project_state.analysis_results.literature_reviews[ID]" - skill_id: "DraftTextualContent" description: "Drafts textual content. Applies Meta-RefineOutput and AIOperationalProtocols." input_parameters_schema: content_topic_or_prompt: "string" content_type: "string (optional) # E.g., 'report_section'. Default: 'general_text'." outline_points: "list of strings (optional)" target_length_qualitative: "string (optional) # E.g., 'brief paragraph'." tone_style_guide_ref: "string (optional) # Ref to StyleGuide KA (base ID)." source_material_references: "list of strings (optional) # Base filenames or project_state paths." output_format: "string (optional) # Enum: 'markdown', 'plaintext'. Default: 'markdown'." llm_parameter_advisory_note: "string (optional) # E.g., 'Suggest high temperature for creative draft'." output_data_schema: type: "document_simple_text" content_inline: "string # The drafted text." format: "string # Actual format used." # --- Data Analysis Skills --- - skill_id: "AnalyzeDataset" description: "Performs data analysis. Applies Meta-RefineOutput and AIOperationalProtocols to interpretation." input_parameters_schema: dataset_reference: "string # Filename (base) or project_state path." analysis_objectives: "list of strings" analysis_type_hint: "string (optional) # Enum: 'StatisticalSummary', 'TrendAnalysis', 'QualitativeCoding', 'Custom'." output_data_schema: type: "analysis_result_reference" analysis_result_ref: "string # Path to created data_analysis_report_object in project_state.analysis_results.data_analyses[ID]" # --- Knowledge Artifact Management Skills --- - skill_id: "ManageGlossaryTerm" description: "Manages glossary terms. Applies Meta-RefineOutput and AIOperationalProtocols to AI-drafted definitions." input_parameters_schema: glossary_id_ref: "string" action: "string # Enum: 'add', 'update', 'deprecate', 'propose_and_confirm_add'. Default: 'propose_and_confirm_add'." term: "string" definition: "string (optional)" new_term_string: "string (optional, if renaming)" notes: "string (optional)" term_status_override: "string (optional) # Enum from term_object.status." auto_confirm_simple_add: "boolean (optional, default: false)" ai_draft_definition: "boolean (optional, default: true for 'propose_and_confirm_add' if definition empty)" output_data_schema: type: "operation_status_report" content_inline: "string # YAML/JSON: {status: 'Success'/'Failure'/'PendingConfirmation', message: '...', details: {term_object_snapshot: {...}}}" format: "yaml_block" - skill_id: "ManageStyleGuideElement" description: "Updates style guide. Applies Meta-RefineOutput and AIOperationalProtocols to AI-drafted text." input_parameters_schema: style_guide_id_ref: "string" element_path: "string" new_value: "string" action_type: "string (optional) # Enum: 'replace', 'append'. Default: 'replace'." request_confirmation: "boolean (optional, default: true)" output_data_schema: type: "operation_status_report" content_inline: "string # YAML/JSON: {status: '...', message: '...', details: {element_path: '...', old_value: '...', new_value: '...'}}" format: "yaml_block" - skill_id: "ManageSuccessMetric" description: "Manages success criteria. Applies Meta-RefineOutput and AIOperationalProtocols to AI-drafted phrasing." input_parameters_schema: success_metrics_id_ref: "string" metric_type: "string # Enum: 'project_success_criterion', 'deliverable_acceptance_criterion', 'task_dod_summary'." action: "string # Enum: 'add', 'update', 'remove'." goal_ref: "string (optional)" metrics_list_to_add_update: "list of strings (optional)" deliverable_ref: "string (optional)" criteria_list_to_add_update: "list of strings (optional)" task_ref: "string (optional)" dod_summary_text_to_add_update: "string (optional)" existing_item_identifier: "string (optional)" request_confirmation: "boolean (optional, default: true)" output_data_schema: type: "operation_status_report" content_inline: "string # YAML/JSON: {status: '...', message: '...'}" format: "yaml_block" - skill_id: "ManageCollabGuideline" description: "Updates collaboration guidelines. Applies Meta-RefineOutput and AIOperationalProtocols to AI-drafted text." input_parameters_schema: collab_guidelines_id_ref: "string" guideline_element_path: "string" new_value: "string" request_confirmation: "boolean (optional, default: true)" output_data_schema: type: "operation_status_report" content_inline: "string # YAML/JSON: {status: '...', message: '...'}" format: "yaml_block" - skill_id: "ManageAiParameterAdvisory" description: "Manages AI LLM Parameter Advisory KA. Applies Meta-RefineOutput and AIOperationalProtocols." input_parameters_schema: ai_parameter_advisory_id_ref: "string" action: "string # Enum: 'create_new', 'update_general_guidance', 'add_phase_guidance', 'update_phase_guidance', 'remove_phase_guidance', 'add_task_type_guidance', 'update_task_type_guidance', 'remove_task_type_guidance'." general_guidance_text: "string (optional)" phase_trigger_value: "string (optional)" recommended_temperature_range_value: "string (optional)" recommended_top_p_range_value: "string (optional)" rationale_text: "string (optional)" task_type_keyword_value: "string (optional)" existing_guidance_identifier: "string (optional)" request_confirmation: "boolean (optional, default: true)" output_data_schema: type: "operation_status_report" content_inline: "string # YAML/JSON: {status: '...', message: '...'}" format: "yaml_block" - skill_id: "ManageAiOperationalProtocols" description: "Manages AI Operational Protocols KA. Applies Meta-RefineOutput and AIOperationalProtocols." input_parameters_schema: ai_operational_protocols_id_ref: "string" action: "string # Enum: 'create_new_from_baseline', 'update_protocol_element', 'add_custom_protocol'." protocol_element_path: "string (optional)" new_value_or_custom_protocol_text: "string (optional)" custom_protocol_id: "string (optional)" request_confirmation: "boolean (optional, default: true)" output_data_schema: type: "operation_status_report" content_inline: "string # YAML/JSON: {status: '...', message: '...', details: {element_path: '...', new_value: '...'}}" format: "yaml_block" # --- Knowledge Artifact Export Skills (TID004) --- - skill_id: "ExportGlossaryAsDocument" description: "Exports glossary. Applies Meta-RefineOutput and AIOperationalProtocols to formatting." input_parameters_schema: glossary_id_ref: "string" output_format: "string (optional) # Enum: 'markdown', 'html', 'plaintext_list'. Default: 'markdown'." include_term_status: "boolean (optional, default: false)" output_data_schema: type: "document_simple_text" content_inline: "string # The formatted glossary." format: "string # Actual format used." - skill_id: "ExportStyleGuideAsDocument" description: "Exports style guide. Applies Meta-RefineOutput and AIOperationalProtocols." input_parameters_schema: { style_guide_id_ref: "string", output_format: "string (optional, default: 'markdown')" } output_data_schema: { type: "document_simple_text", content_inline: "string", format: "string" } - skill_id: "ExportSuccessMetricsAsDocument" description: "Exports success metrics. Applies Meta-RefineOutput and AIOperationalProtocols." input_parameters_schema: { success_metrics_id_ref: "string", output_format: "string (optional, default: 'markdown')" } output_data_schema: { type: "document_simple_text", content_inline: "string", format: "string" } - skill_id: "ExportCollabGuidelinesAsDocument" description: "Exports collaboration guidelines. Applies Meta-RefineOutput and AIOperationalProtocols." input_parameters_schema: { collab_guidelines_id_ref: "string", output_format: "string (optional, default: 'markdown')" } output_data_schema: { type: "document_simple_text", content_inline: "string", format: "string" } # --- Process Improvement & Meta Skills --- - skill_id: "GenerateTemplateImprovementDirective" description: "Generates a structured improvement directive. Applies Meta-RefineOutput and AIOperationalProtocols." input_parameters_schema: target_template_id_or_process_area: "string" observed_issue_description: "string" relevant_project_state_context: "string (optional)" source_insight_or_event_ref: "string (optional)" initial_proposed_change_idea: "string (optional)" output_data_schema: type: "template_improvement_directive_item" format: "yaml_block" content_inline: "string # YAML block of a single directive_object (conforming to TemplateImprovementDirectiveSchema)." # --- CAFE Methodology Specific Skills (Example) --- - skill_id: "AssessFormalismCandidate" description: "Assesses formalism candidate for CAFE. Applies Meta-RefineOutput and AIOperationalProtocols." input_parameters_schema: formalism_name_or_details: "string" requirements_context_ref: "string # Ref to FrameworkState VS criteria." assessment_criteria_list: "list of strings (optional)" stress_test_scenarios: "list of strings (optional)" output_data_schema: type: "analysis_result_reference" analysis_result_ref: "string # Path to created formalism_assessment_object in project_state.analysis_results.formalism_assessments[ID]" # --- Utility/Placeholder Skills --- - skill_id: "NoOp" description: "No operation. Logs a message." input_parameters_schema: message_to_log: "string (optional)" output_data_schema: type: "operation_status_report" content_inline: "string # YAML/JSON: {status: 'Success', message: 'NoOp skill executed. [message_to_log]'}" format: "yaml_block"